Skip to content

Commit ac8209b

Browse files
committed
Update ONVIF connector
1 parent ed9feca commit ac8209b

File tree

8 files changed

+62
-9
lines changed

8 files changed

+62
-9
lines changed

articles/iot-operations/discover-manage-assets/howto-use-http-connector.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ You need any credentials required to access the HTTP source. If the HTTP source
3535

3636
## Deploy the connector for REST/HTTP
3737

38-
[!INCLUDE [deploy-preview-http-connectors](../includes/deploy-preview-media-connectors.md)]
38+
[!INCLUDE [deploy-preview-media-connectors-simple](../includes/deploy-preview-media-connectors-simple.md)]
3939

4040
## Create a device
4141

articles/iot-operations/discover-manage-assets/howto-use-media-connector.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ A camera connected to your network and accessible from your Azure IoT Operations
3737

3838
[!INCLUDE [deploy-preview-media-connectors](../includes/deploy-preview-media-connectors.md)]
3939

40-
## Create a device
40+
## Create a device with a media endpoint
4141

4242
To configure the media connector, first create a device that defines the connection to the media source. The device includes the URL of the media source and any credentials you need to access the media source:
4343

@@ -70,7 +70,7 @@ Run the following commands:
7070
```azurecli
7171
az iot ops ns device create -n media-connector-cli -g {your resource group name} --instance {your instance name}
7272
73-
az iot ops ns device endpoint inbound add media --device media-connector-cli -g {your resource group name} -i {your instance name} --name media-connector-cli-0 --endpoint-address "rtsp://samplecamera:554/stream1"
73+
az iot ops ns device endpoint inbound add media --device media-connector-cli -g {your resource group name} -i {your instance name} --name media-connector-cli-0 --endpoint-address rtsp://samplecamera:554/stream1
7474
```
7575

7676
To learn more, see [az iot ops ns device](/cli/azure/iot/ops/ns/device).

articles/iot-operations/discover-manage-assets/howto-use-onvif-connector.md

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -35,14 +35,13 @@ An ONVIF compliant camera that you can reach from your Azure IoT Operations clus
3535

3636
## Deploy the connector for ONVIF
3737

38-
[!INCLUDE [deploy-preview-media-connectors](../includes/deploy-preview-media-connectors.md)]
39-
40-
> [!IMPORTANT]
41-
> If you don't enable preview features, you see the following error message in the `aio-supervisor-...` pod logs when you try to use the media or ONVIF connectors: `No connector configuration present for AssetEndpointProfile: <AssetEndpointProfileName>`.
38+
[!INCLUDE [deploy-preview-media-connectors-simple](../includes/deploy-preview-media-connectors-simple.md)]
4239

4340
## Create a device with an ONVIF endpoint
4441

45-
To add a device that defines an ONVIF endpoint for a compliant camera, follow these steps:
42+
To add a device that includes an ONVIF endpoint for a compliant camera:
43+
44+
# [Operations experience](#tab/portal)
4645

4746
1. In the operations experience web UI, select **Devices** from the left navigation pane:
4847

@@ -62,6 +61,20 @@ To add a device that defines an ONVIF endpoint for a compliant camera, follow th
6261

6362
:::image type="content" source="media/howto-use-onvif-connector/device-created.png" alt-text="Screenshot that shows the device created in the operations experience." lightbox="media/howto-use-onvif-connector/device-created.png":::
6463

64+
# [Azure CLI](#tab/cli)
65+
66+
Run the following commands:
67+
68+
```azurecli
69+
az iot ops ns device create -n onvif-connector-cli -g {your resource group name} --instance {your instance name}
70+
71+
az iot ops ns device endpoint inbound add onvif --device onvif-connector-cli -g {your resource group name} -i {your instance name} --name onvif-connector-cli-0 --endpoint-address http://myonvifcam:2020/onvif/device_service
72+
```
73+
74+
To learn more, see [az iot ops ns device](/cli/azure/iot/ops/ns/device).
75+
76+
---
77+
6578
## View the discovered assets and devices
6679

6780
After you create a device with an ONVIF endpoint, the connector for ONVIF automatically discovers the assets and devices that are available at the endpoint. To view the discovered assets and devices in the operations experience web UI, select **Discovery** from the left navigation pane:
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: Include file
3+
description: Include file
4+
author: dominicbetts
5+
ms.topic: include
6+
ms.date: 07/25/2025
7+
ms.author: dobett
8+
---
9+
10+
When you deploy the preview version of Azure IoT Operations, the deployment includes the three preview connectors. You can verify that you have a preview instance of Azure IoT Operations by checking in the Azure portal that preview features are enabled for your instance:
11+
12+
:::image type="content" source="media/deploy-preview-media-connectors-simple/portal-enable-preview-connectors.png" alt-text="Screenshot of Azure portal that shows that preview features are enabled." lightbox="media/deploy-preview-media-connectors-simple/portal-enable-preview-connectors.png":::
13+
14+
Before you can use the preview connectors (ONVIF, media, and REST/HTTP) in the operations experience web UI, an administrator must add connector template instances to your Azure IoT Operations instance.
15+
16+
All three preview connectors can publish captured data to the MQTT broker.
17+
18+
To add a connector template instance to your Azure IoT Operations instance:
19+
20+
1. In the Azure portal, go to your Azure IoT Operations instance, select **Connector templates**, and then select **Add connector template instances**:
21+
22+
:::image type="content" source="media/deploy-preview-media-connectors-simple/portal-add-connector-template.png" alt-text="Screenshot of Azure portal that shows how to add a connector template instance." lightbox="media/deploy-preview-media-connectors-simple/portal-add-connector-template.png":::
23+
24+
1. On the first page of the **Add an Akri connector template** wizard, select the type of connector template you want to add, such as **ONVIF**, **Media**, or **HTTP REST**. Then select **Metadata**.
25+
26+
:::image type="content" source="media/deploy-preview-media-connectors-simple/select-connector-template-type.png" alt-text="Screenshot of Azure portal that shows how to select the connector template instance type." lightbox="media/deploy-preview-media-connectors-simple/select-connector-template-type.png":::
27+
28+
1. On the **Metadata** page, accept the defaults, and then select **Device inbound endpoint type**.
29+
30+
1. On the **Device inbound endpoint type** page, accept the defaults, and then select **Diagnostics configurations**.
31+
32+
1. On the **Diagnostics configurations** page, accept the defaults, and then select **Runtime configuration**.
33+
34+
1. On the **Runtime configuration** page, accept the defaults, and then select **Review**:
35+
36+
1. On the **Review** page, review the details of the connector template instance, and then select **Create** to create the connector template instance.
37+
38+
An OT user can now use the operations experience web UI to create a device with a preview connector endpoint.
39+
40+
---

articles/iot-operations/includes/deploy-preview-media-connectors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ When you deploy the preview version of Azure IoT Operations, the deployment incl
1313

1414
Before you can use the preview connectors (ONVIF, media, and REST/HTTP) in the operations experience web UI, an administrator must add connector template instances to your Azure IoT Operations instance.
1515

16-
All three preview connectors can publish captured data to the MQTT broker and save captured data to storage. Azure IoT Operations uses [Azure Container Storage enabled by Azure Arc](/azure/azure-arc/container-storage/overview) to transfer the captured data to cloud storage destinations such as Azure Blob Storage. When you configure a connector template instance, you specify a _persistent volume claim_ and _mount path_ for the connector to use to save captured data. To learn how to create a suitable persistent volume claim, see [Cloud Ingest Edge Volumes configuration](/azure/azure-arc/container-storage/cloud-ingest-edge-volume-configuration).
16+
All three preview connectors can publish captured data to the MQTT broker. The media connector can also save captured data to storage. Azure IoT Operations uses [Azure Container Storage enabled by Azure Arc](/azure/azure-arc/container-storage/overview) to transfer the captured data to cloud storage destinations such as Azure Blob Storage. When you configure a connector template instance, you specify a _persistent volume claim_ and _mount path_ for the connector to use to save captured data. To learn how to create a suitable persistent volume claim, see [Cloud Ingest Edge Volumes configuration](/azure/azure-arc/container-storage/cloud-ingest-edge-volume-configuration).
1717

1818
To add a connector template instance to your Azure IoT Operations instance:
1919

54.4 KB
Loading
91.8 KB
Loading
56.3 KB
Loading

0 commit comments

Comments
 (0)