Namespace Discovered Assets - Create Or Replace

Služba:

Device Registry

Verze rozhraní API:

2025-10-01

Vytvoření oboru názvůDiscoveredAsset

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/namespaces/{namespaceName}/discoveredAssets/{discoveredAssetName}?api-version=2025-10-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
discoveredAssetName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Název zjištěného prostředku.
namespaceName	path	True	string minLength: 3 maxLength: 64 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Název oboru názvů.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
extendedLocation	True	ExtendedLocation	Rozšířené umístění.
location	True	string	Geografické umístění, ve kterém se nachází zdroj
properties.deviceRef	True	DeviceRef	Odkaz na zařízení, které poskytuje data pro tento datový zdroj. Je nutné zadat název zařízení a koncový bod zařízení, které chcete použít.
properties.discoveryId	True	string	Identifikátor použitý k detekci změn v prostředku.
properties.version	True	integer (int64)	Celé číslo, které se zvýší při každé změně prostředku.
properties.assetTypeRefs		string[]	Identifikátory URI nebo ID definic typů.
properties.attributes			Sada párů klíč-hodnota, které obsahují vlastní atributy.
properties.datasets		NamespaceDiscoveredDataset[]	Pole datových sad, které jsou součástí assetu. Každá specifikace datové sady popisuje datové body, které tvoří sadu.
properties.defaultDatasetsConfiguration		string	Řetězecifikovaný JSON, který obsahuje výchozí konfiguraci specifickou pro konektory pro všechny datové sady. Každá datová sada může mít vlastní konfiguraci, která zde přepíše výchozí nastavení.
properties.defaultDatasetsDestinations		DatasetDestination[]: DatasetBrokerStateStoreDestination[] DatasetMqttDestination[] DatasetStorageDestination[]	Výchozí cíle pro datovou sadu.
properties.defaultEventsConfiguration		string	Stringifikovaný JSON, který obsahuje výchozí konfiguraci specifickou pro konektory pro všechny události. Každá událost může mít vlastní konfiguraci, která zde přepíše výchozí nastavení.
properties.defaultEventsDestinations		EventDestination[]: EventMqttDestination[] EventStorageDestination[]	Výchozí cíle pro událost.
properties.defaultManagementGroupsConfiguration		string	Řetězec JSON, který obsahuje výchozí konfiguraci specifickou pro konektor pro všechny skupiny pro správu. Každá skupina pro správu může mít vlastní konfiguraci, která přepíše výchozí nastavení.
properties.defaultStreamsConfiguration		string	Řetězec JSON obsahující výchozí konfiguraci specifickou pro konektor pro všechny datové proudy. Každý datový proud může mít vlastní konfiguraci, která přepíše výchozí nastavení.
properties.defaultStreamsDestinations		StreamDestination[]: StreamMqttDestination[] StreamStorageDestination[]	Výchozí cíle pro stream.
properties.description		string	Popis aktiva čitelný pro člověka.
properties.displayName		string	Zobrazované jméno čitelné pro člověka.
properties.documentationUri		string	Referenční dokumentace k aktivům.
properties.eventGroups		NamespaceDiscoveredEventGroup[]	Pole skupin událostí, které jsou součástí datového zdroje. Každá skupina událostí může mít konfiguraci pro jednotlivé skupiny událostí.
properties.externalAssetId		string	ID datového zdroje poskytnuté zákazníkem.
properties.hardwareRevision		string	Číslo revize hardwaru datového zdroje.
properties.managementGroups		NamespaceDiscoveredManagementGroup[]	Pole skupin pro správu, které jsou součástí datového zdroje. Každá skupina pro správu může mít konfiguraci pro jednotlivé skupiny.
properties.manufacturer		string	Výrobce aktiv.
properties.manufacturerUri		string	Identifikátor URI výrobce majetku.
properties.model		string	Model datového zdroje.
properties.productCode		string	Kód produktu asset.
properties.serialNumber		string	Sériové číslo aktiva.
properties.softwareRevision		string	Číslo revize softwaru Asset.
properties.streams		NamespaceDiscoveredStream[]	Pole datových proudů, které jsou součástí datového zdroje. Každý datový proud může mít konfiguraci pro jednotlivé datové proudy.
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	NamespaceDiscoveredAsset	Operace aktualizace prostředku NamespaceDiscoveredAsset byla úspěšná
201 Created	NamespaceDiscoveredAsset	Operace vytvoření prostředku NamespaceDiscoveredAsset byla úspěšná Hlavičky Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

CreateOrReplace_NamespaceDiscoveredAsset

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/my-namespace-1/discoveredAssets/my-discoveredasset-1?api-version=2025-10-01

{
  "location": "West Europe",
  "extendedLocation": {
    "type": "CustomLocation",
    "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"
  },
  "tags": {
    "site": "building-1"
  },
  "properties": {
    "deviceRef": {
      "deviceName": "myDevice",
      "endpointName": "opcuaendpointname"
    },
    "assetTypeRefs": [
      "myAssetTypeRef1",
      "myAssetTypeRef2"
    ],
    "discoveryId": "11111111-1111-1111-1111-111111111111",
    "version": 73766,
    "manufacturer": "Contoso",
    "manufacturerUri": "https://www.contoso.com/manufacturerUri",
    "model": "ContosoModel",
    "productCode": "SA34VDG",
    "hardwareRevision": "1.0",
    "softwareRevision": "2.0",
    "documentationUri": "https://www.example.com/manual",
    "serialNumber": "64-103816-519918-8",
    "attributes": {
      "floor": "1"
    },
    "defaultDatasetsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultEventsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultStreamsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultManagementGroupsConfiguration": "{\"retryCount\":10,\"retryBackoffInterval\":15}",
    "defaultDatasetsDestinations": [
      {
        "target": "BrokerStateStore",
        "configuration": {
          "key": "defaultValue"
        }
      }
    ],
    "defaultEventsDestinations": [
      {
        "target": "Storage",
        "configuration": {
          "path": "/tmp"
        }
      }
    ],
    "defaultStreamsDestinations": [
      {
        "target": "Mqtt",
        "configuration": {
          "topic": "/contoso/test",
          "retain": "Never",
          "qos": "Qos0",
          "ttl": 3600
        }
      }
    ],
    "datasets": [
      {
        "name": "dataset1",
        "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5",
        "typeRef": "dataset1TypeRef",
        "datasetConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "destinations": [
          {
            "target": "BrokerStateStore",
            "configuration": {
              "key": "dataset1"
            }
          }
        ],
        "dataPoints": [
          {
            "name": "dataset1DataPoint1",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
            "dataPointConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
            "typeRef": "dataset1DataPoint1TypeRef",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          },
          {
            "name": "dataset1DataPoint2",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
            "dataPointConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
            "typeRef": "dataset1DataPoint2TypeRef",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          }
        ]
      }
    ],
    "eventGroups": [
      {
        "name": "default",
        "events": [
          {
            "name": "event1",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
            "eventConfiguration": "{\"publishingInterval\":7,\"samplingInterval\":1,\"queueSize\":8}",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
            "destinations": [
              {
                "target": "Mqtt",
                "configuration": {
                  "topic": "/contoso/testEvent1",
                  "retain": "Keep",
                  "qos": "Qos0",
                  "ttl": 7200
                }
              }
            ],
            "typeRef": "event1Ref"
          },
          {
            "name": "event2",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
            "eventConfiguration": "{\"publishingInterval\":7,\"samplingInterval\":8,\"queueSize\":4}",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
            "destinations": [
              {
                "target": "Storage",
                "configuration": {
                  "path": "/tmp/event2"
                }
              }
            ],
            "typeRef": "event2Ref"
          }
        ]
      }
    ],
    "streams": [
      {
        "name": "stream1",
        "streamConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "typeRef": "stream1TypeRef",
        "destinations": [
          {
            "target": "Storage",
            "configuration": {
              "path": "/tmp/stream1"
            }
          }
        ]
      },
      {
        "name": "stream2",
        "streamConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "typeRef": "stream2TypeRef",
        "destinations": [
          {
            "target": "Mqtt",
            "configuration": {
              "topic": "/contoso/testStream2",
              "retain": "Never",
              "qos": "Qos0",
              "ttl": 7200
            }
          }
        ]
      }
    ],
    "managementGroups": [
      {
        "name": "managementGroup1",
        "managementGroupConfiguration": "{\"retryCount\":10,\"retryBackoffInterval\":15}",
        "typeRef": "managementGroup1TypeRef",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "defaultTopic": "/contoso/managementGroup1",
        "defaultTimeoutInSeconds": 100,
        "actions": [
          {
            "name": "action1",
            "actionConfiguration": "{\"retryCount\":5,\"retryBackoffInterval\":5}",
            "targetUri": "/onvif/device_service?ONVIFProfile=Profile1",
            "topic": "/contoso/managementGroup1/action1",
            "typeRef": "action1TypeRef",
            "actionType": "Call",
            "timeoutInSeconds": 60,
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          },
          {
            "name": "action2",
            "actionConfiguration": "{\"retryCount\":5,\"retryBackoffInterval\":5}",
            "targetUri": "/onvif/device_service?ONVIFProfile=Profile2",
            "topic": "/contoso/managementGroup1/action2",
            "typeRef": "action2TypeRef",
            "actionType": "Call",
            "timeoutInSeconds": 60,
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          }
        ]
      }
    ]
  }
}

Java

import com.azure.core.util.BinaryData;
import com.azure.resourcemanager.deviceregistry.models.BrokerStateStoreDestinationConfiguration;
import com.azure.resourcemanager.deviceregistry.models.DatasetBrokerStateStoreDestination;
import com.azure.resourcemanager.deviceregistry.models.DeviceRef;
import com.azure.resourcemanager.deviceregistry.models.EventMqttDestination;
import com.azure.resourcemanager.deviceregistry.models.EventStorageDestination;
import com.azure.resourcemanager.deviceregistry.models.ExtendedLocation;
import com.azure.resourcemanager.deviceregistry.models.MqttDestinationConfiguration;
import com.azure.resourcemanager.deviceregistry.models.MqttDestinationQos;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredAssetProperties;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredDataset;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredDatasetDataPoint;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredEvent;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredEventGroup;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredManagementAction;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredManagementActionType;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredManagementGroup;
import com.azure.resourcemanager.deviceregistry.models.NamespaceDiscoveredStream;
import com.azure.resourcemanager.deviceregistry.models.StorageDestinationConfiguration;
import com.azure.resourcemanager.deviceregistry.models.StreamMqttDestination;
import com.azure.resourcemanager.deviceregistry.models.StreamStorageDestination;
import com.azure.resourcemanager.deviceregistry.models.TopicRetainType;
import java.nio.charset.StandardCharsets;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for NamespaceDiscoveredAssets CreateOrReplace.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-10-01/CreateOrReplace_NamespaceDiscoveredAsset.json
     */
    /**
     * Sample code: CreateOrReplace_NamespaceDiscoveredAsset.
     * 
     * @param manager Entry point to DeviceRegistryManager.
     */
    public static void createOrReplaceNamespaceDiscoveredAsset(
        com.azure.resourcemanager.deviceregistry.DeviceRegistryManager manager) {
        manager.namespaceDiscoveredAssets().define("my-discoveredasset-1").withRegion("West Europe")
            .withExistingNamespace("myResourceGroup", "my-namespace-1")
            .withExtendedLocation(new ExtendedLocation().withType("CustomLocation").withName(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"))
            .withTags(mapOf("site", "building-1"))
            .withProperties(new NamespaceDiscoveredAssetProperties()
                .withDeviceRef(new DeviceRef().withDeviceName("myDevice").withEndpointName("opcuaendpointname"))
                .withAssetTypeRefs(Arrays.asList("myAssetTypeRef1", "myAssetTypeRef2"))
                .withDiscoveryId("11111111-1111-1111-1111-111111111111").withVersion(73766L).withManufacturer("Contoso")
                .withManufacturerUri("https://www.contoso.com/manufacturerUri").withModel("ContosoModel")
                .withProductCode("fakeTokenPlaceholder").withHardwareRevision("1.0").withSoftwareRevision("2.0")
                .withDocumentationUri("https://www.example.com/manual").withSerialNumber("64-103816-519918-8")
                .withAttributes(mapOf("floor", BinaryData.fromBytes("1".getBytes(StandardCharsets.UTF_8))))
                .withDefaultDatasetsConfiguration(
                    "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}")
                .withDefaultEventsConfiguration("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}")
                .withDefaultStreamsConfiguration("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}")
                .withDefaultManagementGroupsConfiguration("{\"retryCount\":10,\"retryBackoffInterval\":15}")
                .withDefaultDatasetsDestinations(Arrays.asList(new DatasetBrokerStateStoreDestination()
                    .withConfiguration(new BrokerStateStoreDestinationConfiguration().withKey("fakeTokenPlaceholder"))))
                .withDefaultEventsDestinations(Arrays.asList(new EventStorageDestination()
                    .withConfiguration(new StorageDestinationConfiguration().withPath("/tmp"))))
                .withDefaultStreamsDestinations(Arrays.asList(new StreamMqttDestination()
                    .withConfiguration(new MqttDestinationConfiguration().withTopic("/contoso/test")
                        .withRetain(TopicRetainType.NEVER).withQos(MqttDestinationQos.QOS0).withTtl(3600L))))
                .withDatasets(Arrays.asList(new NamespaceDiscoveredDataset().withName("dataset1")
                    .withDataSource("nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5").withTypeRef("dataset1TypeRef")
                    .withDatasetConfiguration("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}")
                    .withDestinations(Arrays.asList(new DatasetBrokerStateStoreDestination().withConfiguration(
                        new BrokerStateStoreDestinationConfiguration().withKey("fakeTokenPlaceholder"))))
                    .withDataPoints(Arrays.asList(
                        new NamespaceDiscoveredDatasetDataPoint().withName("dataset1DataPoint1")
                            .withDataSource("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3")
                            .withDataPointConfiguration(
                                "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}")
                            .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z"))
                            .withTypeRef("dataset1DataPoint1TypeRef"),
                        new NamespaceDiscoveredDatasetDataPoint().withName("dataset1DataPoint2")
                            .withDataSource("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4")
                            .withDataPointConfiguration(
                                "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}")
                            .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z"))
                            .withTypeRef("dataset1DataPoint2TypeRef")))
                    .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z"))))
                .withEventGroups(Arrays.asList(new NamespaceDiscoveredEventGroup().withName("default")
                    .withEvents(Arrays.asList(
                        new NamespaceDiscoveredEvent().withName("event1")
                            .withDataSource("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3")
                            .withEventConfiguration("{\"publishingInterval\":7,\"samplingInterval\":1,\"queueSize\":8}")
                            .withDestinations(Arrays.asList(new EventMqttDestination()
                                .withConfiguration(new MqttDestinationConfiguration().withTopic("/contoso/testEvent1")
                                    .withRetain(TopicRetainType.KEEP).withQos(MqttDestinationQos.QOS0).withTtl(7200L))))
                            .withTypeRef("event1Ref")
                            .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z")),
                        new NamespaceDiscoveredEvent().withName("event2")
                            .withDataSource("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4")
                            .withEventConfiguration("{\"publishingInterval\":7,\"samplingInterval\":8,\"queueSize\":4}")
                            .withDestinations(Arrays.asList(new EventStorageDestination()
                                .withConfiguration(new StorageDestinationConfiguration().withPath("/tmp/event2"))))
                            .withTypeRef("event2Ref")
                            .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z"))))))
                .withStreams(Arrays.asList(
                    new NamespaceDiscoveredStream().withName("stream1")
                        .withStreamConfiguration("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}")
                        .withTypeRef("stream1TypeRef")
                        .withDestinations(Arrays.asList(new StreamStorageDestination()
                            .withConfiguration(new StorageDestinationConfiguration().withPath("/tmp/stream1"))))
                        .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z")),
                    new NamespaceDiscoveredStream().withName("stream2")
                        .withStreamConfiguration("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}")
                        .withTypeRef("stream2TypeRef")
                        .withDestinations(Arrays.asList(new StreamMqttDestination()
                            .withConfiguration(new MqttDestinationConfiguration().withTopic("/contoso/testStream2")
                                .withRetain(TopicRetainType.NEVER).withQos(MqttDestinationQos.QOS0).withTtl(7200L))))
                        .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z"))))
                .withManagementGroups(
                    Arrays
                        .asList(
                            new NamespaceDiscoveredManagementGroup().withName("managementGroup1")
                                .withManagementGroupConfiguration("{\"retryCount\":10,\"retryBackoffInterval\":15}")
                                .withTypeRef("managementGroup1TypeRef").withDefaultTopic("/contoso/managementGroup1")
                                .withDefaultTimeoutInSeconds(100)
                                .withActions(
                                    Arrays
                                        .asList(
                                            new NamespaceDiscoveredManagementAction().withName("action1")
                                                .withActionConfiguration(
                                                    "{\"retryCount\":5,\"retryBackoffInterval\":5}")
                                                .withTargetUri("/onvif/device_service?ONVIFProfile=Profile1")
                                                .withTypeRef("action1TypeRef")
                                                .withTopic("/contoso/managementGroup1/action1")
                                                .withActionType(NamespaceDiscoveredManagementActionType.CALL)
                                                .withTimeoutInSeconds(60)
                                                .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z")),
                                            new NamespaceDiscoveredManagementAction().withName("action2")
                                                .withActionConfiguration(
                                                    "{\"retryCount\":5,\"retryBackoffInterval\":5}")
                                                .withTargetUri("/onvif/device_service?ONVIFProfile=Profile2")
                                                .withTypeRef("action2TypeRef")
                                                .withTopic("/contoso/managementGroup1/action2")
                                                .withActionType(NamespaceDiscoveredManagementActionType.CALL)
                                                .withTimeoutInSeconds(60)
                                                .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z"))))
                                .withLastUpdatedOn(OffsetDateTime.parse("2024-04-09T14:20:00.52Z")))))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.deviceregistry import DeviceRegistryMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-deviceregistry
# USAGE
    python create_or_replace_namespace_discovered_asset.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DeviceRegistryMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.namespace_discovered_assets.begin_create_or_replace(
        resource_group_name="myResourceGroup",
        namespace_name="my-namespace-1",
        discovered_asset_name="my-discoveredasset-1",
        resource={
            "extendedLocation": {
                "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1",
                "type": "CustomLocation",
            },
            "location": "West Europe",
            "properties": {
                "assetTypeRefs": ["myAssetTypeRef1", "myAssetTypeRef2"],
                "attributes": {"floor": "1"},
                "datasets": [
                    {
                        "dataPoints": [
                            {
                                "dataPointConfiguration": '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
                                "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
                                "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                                "name": "dataset1DataPoint1",
                                "typeRef": "dataset1DataPoint1TypeRef",
                            },
                            {
                                "dataPointConfiguration": '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
                                "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
                                "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                                "name": "dataset1DataPoint2",
                                "typeRef": "dataset1DataPoint2TypeRef",
                            },
                        ],
                        "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5",
                        "datasetConfiguration": '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
                        "destinations": [{"configuration": {"key": "dataset1"}, "target": "BrokerStateStore"}],
                        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                        "name": "dataset1",
                        "typeRef": "dataset1TypeRef",
                    }
                ],
                "defaultDatasetsConfiguration": '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
                "defaultDatasetsDestinations": [
                    {"configuration": {"key": "defaultValue"}, "target": "BrokerStateStore"}
                ],
                "defaultEventsConfiguration": '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
                "defaultEventsDestinations": [{"configuration": {"path": "/tmp"}, "target": "Storage"}],
                "defaultManagementGroupsConfiguration": '{"retryCount":10,"retryBackoffInterval":15}',
                "defaultStreamsConfiguration": '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
                "defaultStreamsDestinations": [
                    {
                        "configuration": {"qos": "Qos0", "retain": "Never", "topic": "/contoso/test", "ttl": 3600},
                        "target": "Mqtt",
                    }
                ],
                "deviceRef": {"deviceName": "myDevice", "endpointName": "opcuaendpointname"},
                "discoveryId": "11111111-1111-1111-1111-111111111111",
                "documentationUri": "https://www.example.com/manual",
                "eventGroups": [
                    {
                        "events": [
                            {
                                "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
                                "destinations": [
                                    {
                                        "configuration": {
                                            "qos": "Qos0",
                                            "retain": "Keep",
                                            "topic": "/contoso/testEvent1",
                                            "ttl": 7200,
                                        },
                                        "target": "Mqtt",
                                    }
                                ],
                                "eventConfiguration": '{"publishingInterval":7,"samplingInterval":1,"queueSize":8}',
                                "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                                "name": "event1",
                                "typeRef": "event1Ref",
                            },
                            {
                                "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
                                "destinations": [{"configuration": {"path": "/tmp/event2"}, "target": "Storage"}],
                                "eventConfiguration": '{"publishingInterval":7,"samplingInterval":8,"queueSize":4}',
                                "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                                "name": "event2",
                                "typeRef": "event2Ref",
                            },
                        ],
                        "name": "default",
                    }
                ],
                "hardwareRevision": "1.0",
                "managementGroups": [
                    {
                        "actions": [
                            {
                                "actionConfiguration": '{"retryCount":5,"retryBackoffInterval":5}',
                                "actionType": "Call",
                                "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                                "name": "action1",
                                "targetUri": "/onvif/device_service?ONVIFProfile=Profile1",
                                "timeoutInSeconds": 60,
                                "topic": "/contoso/managementGroup1/action1",
                                "typeRef": "action1TypeRef",
                            },
                            {
                                "actionConfiguration": '{"retryCount":5,"retryBackoffInterval":5}',
                                "actionType": "Call",
                                "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                                "name": "action2",
                                "targetUri": "/onvif/device_service?ONVIFProfile=Profile2",
                                "timeoutInSeconds": 60,
                                "topic": "/contoso/managementGroup1/action2",
                                "typeRef": "action2TypeRef",
                            },
                        ],
                        "defaultTimeoutInSeconds": 100,
                        "defaultTopic": "/contoso/managementGroup1",
                        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                        "managementGroupConfiguration": '{"retryCount":10,"retryBackoffInterval":15}',
                        "name": "managementGroup1",
                        "typeRef": "managementGroup1TypeRef",
                    }
                ],
                "manufacturer": "Contoso",
                "manufacturerUri": "https://www.contoso.com/manufacturerUri",
                "model": "ContosoModel",
                "productCode": "SA34VDG",
                "serialNumber": "64-103816-519918-8",
                "softwareRevision": "2.0",
                "streams": [
                    {
                        "destinations": [{"configuration": {"path": "/tmp/stream1"}, "target": "Storage"}],
                        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                        "name": "stream1",
                        "streamConfiguration": '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
                        "typeRef": "stream1TypeRef",
                    },
                    {
                        "destinations": [
                            {
                                "configuration": {
                                    "qos": "Qos0",
                                    "retain": "Never",
                                    "topic": "/contoso/testStream2",
                                    "ttl": 7200,
                                },
                                "target": "Mqtt",
                            }
                        ],
                        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
                        "name": "stream2",
                        "streamConfiguration": '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
                        "typeRef": "stream2TypeRef",
                    },
                ],
                "version": 73766,
            },
            "tags": {"site": "building-1"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-10-01/CreateOrReplace_NamespaceDiscoveredAsset.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armdeviceregistry_test

import (
	"context"
	"log"
	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/deviceregistry/armdeviceregistry/v2"
)

// Generated from example definition: 2025-10-01/CreateOrReplace_NamespaceDiscoveredAsset.json
func ExampleNamespaceDiscoveredAssetsClient_BeginCreateOrReplace() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdeviceregistry.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewNamespaceDiscoveredAssetsClient().BeginCreateOrReplace(ctx, "myResourceGroup", "my-namespace-1", "my-discoveredasset-1", armdeviceregistry.NamespaceDiscoveredAsset{
		Location: to.Ptr("West Europe"),
		ExtendedLocation: &armdeviceregistry.ExtendedLocation{
			Type: to.Ptr("CustomLocation"),
			Name: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"),
		},
		Tags: map[string]*string{
			"site": to.Ptr("building-1"),
		},
		Properties: &armdeviceregistry.NamespaceDiscoveredAssetProperties{
			DeviceRef: &armdeviceregistry.DeviceRef{
				DeviceName:   to.Ptr("myDevice"),
				EndpointName: to.Ptr("opcuaendpointname"),
			},
			AssetTypeRefs: []*string{
				to.Ptr("myAssetTypeRef1"),
				to.Ptr("myAssetTypeRef2"),
			},
			DiscoveryID:      to.Ptr("11111111-1111-1111-1111-111111111111"),
			Version:          to.Ptr[int64](73766),
			Manufacturer:     to.Ptr("Contoso"),
			ManufacturerURI:  to.Ptr("https://www.contoso.com/manufacturerUri"),
			Model:            to.Ptr("ContosoModel"),
			ProductCode:      to.Ptr("SA34VDG"),
			HardwareRevision: to.Ptr("1.0"),
			SoftwareRevision: to.Ptr("2.0"),
			DocumentationURI: to.Ptr("https://www.example.com/manual"),
			SerialNumber:     to.Ptr("64-103816-519918-8"),
			Attributes: map[string]any{
				"floor": "1",
			},
			DefaultDatasetsConfiguration:         to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
			DefaultEventsConfiguration:           to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
			DefaultStreamsConfiguration:          to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
			DefaultManagementGroupsConfiguration: to.Ptr("{\"retryCount\":10,\"retryBackoffInterval\":15}"),
			DefaultDatasetsDestinations: []armdeviceregistry.DatasetDestinationClassification{
				&armdeviceregistry.DatasetBrokerStateStoreDestination{
					Target: to.Ptr(armdeviceregistry.DatasetDestinationTargetBrokerStateStore),
					Configuration: &armdeviceregistry.BrokerStateStoreDestinationConfiguration{
						Key: to.Ptr("defaultValue"),
					},
				},
			},
			DefaultEventsDestinations: []armdeviceregistry.EventDestinationClassification{
				&armdeviceregistry.EventStorageDestination{
					Target: to.Ptr(armdeviceregistry.EventDestinationTargetStorage),
					Configuration: &armdeviceregistry.StorageDestinationConfiguration{
						Path: to.Ptr("/tmp"),
					},
				},
			},
			DefaultStreamsDestinations: []armdeviceregistry.StreamDestinationClassification{
				&armdeviceregistry.StreamMqttDestination{
					Target: to.Ptr(armdeviceregistry.StreamDestinationTargetMqtt),
					Configuration: &armdeviceregistry.MqttDestinationConfiguration{
						Topic:  to.Ptr("/contoso/test"),
						Retain: to.Ptr(armdeviceregistry.TopicRetainTypeNever),
						Qos:    to.Ptr(armdeviceregistry.MqttDestinationQosQos0),
						TTL:    to.Ptr[int64](3600),
					},
				},
			},
			Datasets: []*armdeviceregistry.NamespaceDiscoveredDataset{
				{
					Name:                 to.Ptr("dataset1"),
					DataSource:           to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5"),
					TypeRef:              to.Ptr("dataset1TypeRef"),
					DatasetConfiguration: to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
					LastUpdatedOn:        to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
					Destinations: []armdeviceregistry.DatasetDestinationClassification{
						&armdeviceregistry.DatasetBrokerStateStoreDestination{
							Target: to.Ptr(armdeviceregistry.DatasetDestinationTargetBrokerStateStore),
							Configuration: &armdeviceregistry.BrokerStateStoreDestinationConfiguration{
								Key: to.Ptr("dataset1"),
							},
						},
					},
					DataPoints: []*armdeviceregistry.NamespaceDiscoveredDatasetDataPoint{
						{
							Name:                   to.Ptr("dataset1DataPoint1"),
							DataSource:             to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3"),
							DataPointConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
							TypeRef:                to.Ptr("dataset1DataPoint1TypeRef"),
							LastUpdatedOn:          to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
						},
						{
							Name:                   to.Ptr("dataset1DataPoint2"),
							DataSource:             to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4"),
							DataPointConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
							TypeRef:                to.Ptr("dataset1DataPoint2TypeRef"),
							LastUpdatedOn:          to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
						},
					},
				},
			},
			EventGroups: []*armdeviceregistry.NamespaceDiscoveredEventGroup{
				{
					Name: to.Ptr("default"),
					Events: []*armdeviceregistry.NamespaceDiscoveredEvent{
						{
							Name:               to.Ptr("event1"),
							DataSource:         to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3"),
							EventConfiguration: to.Ptr("{\"publishingInterval\":7,\"samplingInterval\":1,\"queueSize\":8}"),
							LastUpdatedOn:      to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
							Destinations: []armdeviceregistry.EventDestinationClassification{
								&armdeviceregistry.EventMqttDestination{
									Target: to.Ptr(armdeviceregistry.EventDestinationTargetMqtt),
									Configuration: &armdeviceregistry.MqttDestinationConfiguration{
										Topic:  to.Ptr("/contoso/testEvent1"),
										Retain: to.Ptr(armdeviceregistry.TopicRetainTypeKeep),
										Qos:    to.Ptr(armdeviceregistry.MqttDestinationQosQos0),
										TTL:    to.Ptr[int64](7200),
									},
								},
							},
							TypeRef: to.Ptr("event1Ref"),
						},
						{
							Name:               to.Ptr("event2"),
							DataSource:         to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4"),
							EventConfiguration: to.Ptr("{\"publishingInterval\":7,\"samplingInterval\":8,\"queueSize\":4}"),
							LastUpdatedOn:      to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
							Destinations: []armdeviceregistry.EventDestinationClassification{
								&armdeviceregistry.EventStorageDestination{
									Target: to.Ptr(armdeviceregistry.EventDestinationTargetStorage),
									Configuration: &armdeviceregistry.StorageDestinationConfiguration{
										Path: to.Ptr("/tmp/event2"),
									},
								},
							},
							TypeRef: to.Ptr("event2Ref"),
						},
					},
				},
			},
			Streams: []*armdeviceregistry.NamespaceDiscoveredStream{
				{
					Name:                to.Ptr("stream1"),
					StreamConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
					LastUpdatedOn:       to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
					TypeRef:             to.Ptr("stream1TypeRef"),
					Destinations: []armdeviceregistry.StreamDestinationClassification{
						&armdeviceregistry.StreamStorageDestination{
							Target: to.Ptr(armdeviceregistry.StreamDestinationTargetStorage),
							Configuration: &armdeviceregistry.StorageDestinationConfiguration{
								Path: to.Ptr("/tmp/stream1"),
							},
						},
					},
				},
				{
					Name:                to.Ptr("stream2"),
					StreamConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
					LastUpdatedOn:       to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
					TypeRef:             to.Ptr("stream2TypeRef"),
					Destinations: []armdeviceregistry.StreamDestinationClassification{
						&armdeviceregistry.StreamMqttDestination{
							Target: to.Ptr(armdeviceregistry.StreamDestinationTargetMqtt),
							Configuration: &armdeviceregistry.MqttDestinationConfiguration{
								Topic:  to.Ptr("/contoso/testStream2"),
								Retain: to.Ptr(armdeviceregistry.TopicRetainTypeNever),
								Qos:    to.Ptr(armdeviceregistry.MqttDestinationQosQos0),
								TTL:    to.Ptr[int64](7200),
							},
						},
					},
				},
			},
			ManagementGroups: []*armdeviceregistry.NamespaceDiscoveredManagementGroup{
				{
					Name:                         to.Ptr("managementGroup1"),
					ManagementGroupConfiguration: to.Ptr("{\"retryCount\":10,\"retryBackoffInterval\":15}"),
					TypeRef:                      to.Ptr("managementGroup1TypeRef"),
					LastUpdatedOn:                to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
					DefaultTopic:                 to.Ptr("/contoso/managementGroup1"),
					DefaultTimeoutInSeconds:      to.Ptr[int32](100),
					Actions: []*armdeviceregistry.NamespaceDiscoveredManagementAction{
						{
							Name:                to.Ptr("action1"),
							ActionConfiguration: to.Ptr("{\"retryCount\":5,\"retryBackoffInterval\":5}"),
							TargetURI:           to.Ptr("/onvif/device_service?ONVIFProfile=Profile1"),
							Topic:               to.Ptr("/contoso/managementGroup1/action1"),
							TypeRef:             to.Ptr("action1TypeRef"),
							ActionType:          to.Ptr(armdeviceregistry.NamespaceDiscoveredManagementActionTypeCall),
							TimeoutInSeconds:    to.Ptr[int32](60),
							LastUpdatedOn:       to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
						},
						{
							Name:                to.Ptr("action2"),
							ActionConfiguration: to.Ptr("{\"retryCount\":5,\"retryBackoffInterval\":5}"),
							TargetURI:           to.Ptr("/onvif/device_service?ONVIFProfile=Profile2"),
							Topic:               to.Ptr("/contoso/managementGroup1/action2"),
							TypeRef:             to.Ptr("action2TypeRef"),
							ActionType:          to.Ptr(armdeviceregistry.NamespaceDiscoveredManagementActionTypeCall),
							TimeoutInSeconds:    to.Ptr[int32](60),
							LastUpdatedOn:       to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t }()),
						},
					},
				},
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armdeviceregistry.NamespaceDiscoveredAssetsClientCreateOrReplaceResponse{
	// 	NamespaceDiscoveredAsset: &armdeviceregistry.NamespaceDiscoveredAsset{
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/my-namespace-1/discoveredAssets/my-discoveredasset-1"),
	// 		Name: to.Ptr("my-discoveredasset-1"),
	// 		Type: to.Ptr("Microsoft.DeviceRegistry/namespaces/discoveredAssets"),
	// 		Location: to.Ptr("West Europe"),
	// 		ExtendedLocation: &armdeviceregistry.ExtendedLocation{
	// 			Type: to.Ptr("CustomLocation"),
	// 			Name: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"),
	// 		},
	// 		Tags: map[string]*string{
	// 			"site": to.Ptr("building-1"),
	// 		},
	// 		SystemData: &armdeviceregistry.SystemData{
	// 			CreatedBy: to.Ptr("2ta23112-4596-44ff-b773-19405922bfc1"),
	// 			CreatedByType: to.Ptr(armdeviceregistry.CreatedByTypeApplication),
	// 			CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-11-16T00:36:43.2516899Z"); return t}()),
	// 			LastModifiedBy: to.Ptr("2ta23112-4596-44ff-b773-19405922bfc1"),
	// 			LastModifiedByType: to.Ptr(armdeviceregistry.CreatedByTypeApplication),
	// 			LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-11-16T01:37:16.0922793Z"); return t}()),
	// 		},
	// 		Properties: &armdeviceregistry.NamespaceDiscoveredAssetProperties{
	// 			DeviceRef: &armdeviceregistry.DeviceRef{
	// 				DeviceName: to.Ptr("myDevice"),
	// 				EndpointName: to.Ptr("opcuaendpointname"),
	// 			},
	// 			AssetTypeRefs: []*string{
	// 				to.Ptr("myAssetTypeRef1"),
	// 				to.Ptr("myAssetTypeRef2"),
	// 			},
	// 			DiscoveryID: to.Ptr("11111111-1111-1111-1111-111111111111"),
	// 			Version: to.Ptr[int64](73766),
	// 			Manufacturer: to.Ptr("Contoso"),
	// 			ManufacturerURI: to.Ptr("https://www.contoso.com/manufacturerUri"),
	// 			Model: to.Ptr("ContosoModel"),
	// 			ProductCode: to.Ptr("SA34VDG"),
	// 			HardwareRevision: to.Ptr("1.0"),
	// 			SoftwareRevision: to.Ptr("2.0"),
	// 			DocumentationURI: to.Ptr("https://www.example.com/manual"),
	// 			SerialNumber: to.Ptr("64-103816-519918-8"),
	// 			Attributes: map[string]any{
	// 				"floor": "1",
	// 			},
	// 			DefaultDatasetsConfiguration: to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
	// 			DefaultEventsConfiguration: to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
	// 			DefaultStreamsConfiguration: to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
	// 			DefaultManagementGroupsConfiguration: to.Ptr("{\"retryCount\":10,\"retryBackoffInterval\":15}"),
	// 			DefaultDatasetsDestinations: []armdeviceregistry.DatasetDestinationClassification{
	// 				&armdeviceregistry.DatasetBrokerStateStoreDestination{
	// 					Target: to.Ptr(armdeviceregistry.DatasetDestinationTargetBrokerStateStore),
	// 					Configuration: &armdeviceregistry.BrokerStateStoreDestinationConfiguration{
	// 						Key: to.Ptr("defaultValue"),
	// 					},
	// 				},
	// 			},
	// 			DefaultEventsDestinations: []armdeviceregistry.EventDestinationClassification{
	// 				&armdeviceregistry.EventStorageDestination{
	// 					Target: to.Ptr(armdeviceregistry.EventDestinationTargetStorage),
	// 					Configuration: &armdeviceregistry.StorageDestinationConfiguration{
	// 						Path: to.Ptr("/tmp"),
	// 					},
	// 				},
	// 			},
	// 			DefaultStreamsDestinations: []armdeviceregistry.StreamDestinationClassification{
	// 				&armdeviceregistry.StreamMqttDestination{
	// 					Target: to.Ptr(armdeviceregistry.StreamDestinationTargetMqtt),
	// 					Configuration: &armdeviceregistry.MqttDestinationConfiguration{
	// 						Topic: to.Ptr("/contoso/test"),
	// 						Retain: to.Ptr(armdeviceregistry.TopicRetainTypeNever),
	// 						Qos: to.Ptr(armdeviceregistry.MqttDestinationQosQos0),
	// 						TTL: to.Ptr[int64](3600),
	// 					},
	// 				},
	// 			},
	// 			Datasets: []*armdeviceregistry.NamespaceDiscoveredDataset{
	// 				{
	// 					Name: to.Ptr("dataset1"),
	// 					DataSource: to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5"),
	// 					TypeRef: to.Ptr("dataset1TypeRef"),
	// 					DatasetConfiguration: to.Ptr("{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}"),
	// 					LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 					Destinations: []armdeviceregistry.DatasetDestinationClassification{
	// 						&armdeviceregistry.DatasetBrokerStateStoreDestination{
	// 							Target: to.Ptr(armdeviceregistry.DatasetDestinationTargetBrokerStateStore),
	// 							Configuration: &armdeviceregistry.BrokerStateStoreDestinationConfiguration{
	// 								Key: to.Ptr("dataset1"),
	// 							},
	// 						},
	// 					},
	// 					DataPoints: []*armdeviceregistry.NamespaceDiscoveredDatasetDataPoint{
	// 						{
	// 							Name: to.Ptr("dataset1DataPoint1"),
	// 							DataSource: to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3"),
	// 							DataPointConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
	// 							TypeRef: to.Ptr("dataset1DataPoint1TypeRef"),
	// 							LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 						},
	// 						{
	// 							Name: to.Ptr("dataset1DataPoint2"),
	// 							DataSource: to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4"),
	// 							DataPointConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
	// 							TypeRef: to.Ptr("dataset1DataPoint2TypeRef"),
	// 							LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 						},
	// 					},
	// 				},
	// 			},
	// 			EventGroups: []*armdeviceregistry.NamespaceDiscoveredEventGroup{
	// 				{
	// 					Name: to.Ptr("default"),
	// 					Events: []*armdeviceregistry.NamespaceDiscoveredEvent{
	// 						{
	// 							Name: to.Ptr("event1"),
	// 							DataSource: to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3"),
	// 							EventConfiguration: to.Ptr("{\"publishingInterval\":7,\"samplingInterval\":1,\"queueSize\":8}"),
	// 							LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 							Destinations: []armdeviceregistry.EventDestinationClassification{
	// 								&armdeviceregistry.EventMqttDestination{
	// 									Target: to.Ptr(armdeviceregistry.EventDestinationTargetMqtt),
	// 									Configuration: &armdeviceregistry.MqttDestinationConfiguration{
	// 										Topic: to.Ptr("/contoso/testEvent1"),
	// 										Retain: to.Ptr(armdeviceregistry.TopicRetainTypeKeep),
	// 										Qos: to.Ptr(armdeviceregistry.MqttDestinationQosQos0),
	// 										TTL: to.Ptr[int64](7200),
	// 									},
	// 								},
	// 							},
	// 							TypeRef: to.Ptr("event1Ref"),
	// 						},
	// 						{
	// 							Name: to.Ptr("event2"),
	// 							DataSource: to.Ptr("nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4"),
	// 							EventConfiguration: to.Ptr("{\"publishingInterval\":7,\"samplingInterval\":8,\"queueSize\":4}"),
	// 							LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 							Destinations: []armdeviceregistry.EventDestinationClassification{
	// 								&armdeviceregistry.EventStorageDestination{
	// 									Target: to.Ptr(armdeviceregistry.EventDestinationTargetStorage),
	// 									Configuration: &armdeviceregistry.StorageDestinationConfiguration{
	// 										Path: to.Ptr("/tmp/event2"),
	// 									},
	// 								},
	// 							},
	// 							TypeRef: to.Ptr("event2Ref"),
	// 						},
	// 					},
	// 				},
	// 			},
	// 			Streams: []*armdeviceregistry.NamespaceDiscoveredStream{
	// 				{
	// 					Name: to.Ptr("stream1"),
	// 					StreamConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
	// 					LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 					TypeRef: to.Ptr("stream1TypeRef"),
	// 					Destinations: []armdeviceregistry.StreamDestinationClassification{
	// 						&armdeviceregistry.StreamStorageDestination{
	// 							Target: to.Ptr(armdeviceregistry.StreamDestinationTargetStorage),
	// 							Configuration: &armdeviceregistry.StorageDestinationConfiguration{
	// 								Path: to.Ptr("/tmp/stream1"),
	// 							},
	// 						},
	// 					},
	// 				},
	// 				{
	// 					Name: to.Ptr("stream2"),
	// 					StreamConfiguration: to.Ptr("{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}"),
	// 					LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 					TypeRef: to.Ptr("stream2TypeRef"),
	// 					Destinations: []armdeviceregistry.StreamDestinationClassification{
	// 						&armdeviceregistry.StreamMqttDestination{
	// 							Target: to.Ptr(armdeviceregistry.StreamDestinationTargetMqtt),
	// 							Configuration: &armdeviceregistry.MqttDestinationConfiguration{
	// 								Topic: to.Ptr("/contoso/testStream2"),
	// 								Retain: to.Ptr(armdeviceregistry.TopicRetainTypeNever),
	// 								Qos: to.Ptr(armdeviceregistry.MqttDestinationQosQos0),
	// 								TTL: to.Ptr[int64](7200),
	// 							},
	// 						},
	// 					},
	// 				},
	// 			},
	// 			ManagementGroups: []*armdeviceregistry.NamespaceDiscoveredManagementGroup{
	// 				{
	// 					Name: to.Ptr("managementGroup1"),
	// 					ManagementGroupConfiguration: to.Ptr("{\"retryCount\":10,\"retryBackoffInterval\":15}"),
	// 					TypeRef: to.Ptr("managementGroup1TypeRef"),
	// 					LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 					DefaultTopic: to.Ptr("/contoso/managementGroup1"),
	// 					DefaultTimeoutInSeconds: to.Ptr[int32](100),
	// 					Actions: []*armdeviceregistry.NamespaceDiscoveredManagementAction{
	// 						{
	// 							Name: to.Ptr("action1"),
	// 							ActionConfiguration: to.Ptr("{\"retryCount\":5,\"retryBackoffInterval\":5}"),
	// 							TargetURI: to.Ptr("/onvif/device_service?ONVIFProfile=Profile1"),
	// 							Topic: to.Ptr("/contoso/managementGroup1/action1"),
	// 							TypeRef: to.Ptr("action1TypeRef"),
	// 							ActionType: to.Ptr(armdeviceregistry.NamespaceDiscoveredManagementActionTypeCall),
	// 							TimeoutInSeconds: to.Ptr[int32](60),
	// 							LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 						},
	// 						{
	// 							Name: to.Ptr("action2"),
	// 							ActionConfiguration: to.Ptr("{\"retryCount\":5,\"retryBackoffInterval\":5}"),
	// 							TargetURI: to.Ptr("/onvif/device_service?ONVIFProfile=Profile2"),
	// 							Topic: to.Ptr("/contoso/managementGroup1/action2"),
	// 							TypeRef: to.Ptr("action2TypeRef"),
	// 							ActionType: to.Ptr(armdeviceregistry.NamespaceDiscoveredManagementActionTypeCall),
	// 							TimeoutInSeconds: to.Ptr[int32](60),
	// 							LastUpdatedOn: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-04-09T14:20:00.52Z"); return t}()),
	// 						},
	// 					},
	// 				},
	// 			},
	// 			ProvisioningState: to.Ptr(armdeviceregistry.ProvisioningStateAccepted),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { DeviceRegistryManagementClient } = require("@azure/arm-deviceregistry");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create a NamespaceDiscoveredAsset
 *
 * @summary create a NamespaceDiscoveredAsset
 * x-ms-original-file: 2025-10-01/CreateOrReplace_NamespaceDiscoveredAsset.json
 */
async function createOrReplaceNamespaceDiscoveredAsset() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new DeviceRegistryManagementClient(credential, subscriptionId);
  const result = await client.namespaceDiscoveredAssets.createOrReplace(
    "myResourceGroup",
    "my-namespace-1",
    "my-discoveredasset-1",
    {
      location: "West Europe",
      extendedLocation: {
        type: "CustomLocation",
        name: "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1",
      },
      tags: { site: "building-1" },
      properties: {
        deviceRef: {
          deviceName: "myDevice",
          endpointName: "opcuaendpointname",
        },
        assetTypeRefs: ["myAssetTypeRef1", "myAssetTypeRef2"],
        discoveryId: "11111111-1111-1111-1111-111111111111",
        version: 73766,
        manufacturer: "Contoso",
        manufacturerUri: "https://www.contoso.com/manufacturerUri",
        model: "ContosoModel",
        productCode: "SA34VDG",
        hardwareRevision: "1.0",
        softwareRevision: "2.0",
        documentationUri: "https://www.example.com/manual",
        serialNumber: "64-103816-519918-8",
        attributes: { floor: "1" },
        defaultDatasetsConfiguration:
          '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
        defaultEventsConfiguration:
          '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
        defaultStreamsConfiguration:
          '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
        defaultManagementGroupsConfiguration: '{"retryCount":10,"retryBackoffInterval":15}',
        defaultDatasetsDestinations: [
          {
            target: "BrokerStateStore",
            configuration: { key: "defaultValue" },
          },
        ],
        defaultEventsDestinations: [{ target: "Storage", configuration: { path: "/tmp" } }],
        defaultStreamsDestinations: [
          {
            target: "Mqtt",
            configuration: {
              topic: "/contoso/test",
              retain: "Never",
              qos: "Qos0",
              ttl: 3600,
            },
          },
        ],
        datasets: [
          {
            name: "dataset1",
            dataSource: "nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5",
            typeRef: "dataset1TypeRef",
            datasetConfiguration: '{"publishingInterval":10,"samplingInterval":15,"queueSize":20}',
            lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
            destinations: [
              {
                target: "BrokerStateStore",
                configuration: { key: "dataset1" },
              },
            ],
            dataPoints: [
              {
                name: "dataset1DataPoint1",
                dataSource: "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
                dataPointConfiguration:
                  '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
                typeRef: "dataset1DataPoint1TypeRef",
                lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
              },
              {
                name: "dataset1DataPoint2",
                dataSource: "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
                dataPointConfiguration:
                  '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
                typeRef: "dataset1DataPoint2TypeRef",
                lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
              },
            ],
          },
        ],
        eventGroups: [
          {
            name: "default",
            events: [
              {
                name: "event1",
                dataSource: "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
                eventConfiguration: '{"publishingInterval":7,"samplingInterval":1,"queueSize":8}',
                lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
                destinations: [
                  {
                    target: "Mqtt",
                    configuration: {
                      topic: "/contoso/testEvent1",
                      retain: "Keep",
                      qos: "Qos0",
                      ttl: 7200,
                    },
                  },
                ],
                typeRef: "event1Ref",
              },
              {
                name: "event2",
                dataSource: "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
                eventConfiguration: '{"publishingInterval":7,"samplingInterval":8,"queueSize":4}',
                lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
                destinations: [{ target: "Storage", configuration: { path: "/tmp/event2" } }],
                typeRef: "event2Ref",
              },
            ],
          },
        ],
        streams: [
          {
            name: "stream1",
            streamConfiguration: '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
            lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
            typeRef: "stream1TypeRef",
            destinations: [{ target: "Storage", configuration: { path: "/tmp/stream1" } }],
          },
          {
            name: "stream2",
            streamConfiguration: '{"publishingInterval":8,"samplingInterval":8,"queueSize":4}',
            lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
            typeRef: "stream2TypeRef",
            destinations: [
              {
                target: "Mqtt",
                configuration: {
                  topic: "/contoso/testStream2",
                  retain: "Never",
                  qos: "Qos0",
                  ttl: 7200,
                },
              },
            ],
          },
        ],
        managementGroups: [
          {
            name: "managementGroup1",
            managementGroupConfiguration: '{"retryCount":10,"retryBackoffInterval":15}',
            typeRef: "managementGroup1TypeRef",
            lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
            defaultTopic: "/contoso/managementGroup1",
            defaultTimeoutInSeconds: 100,
            actions: [
              {
                name: "action1",
                actionConfiguration: '{"retryCount":5,"retryBackoffInterval":5}',
                targetUri: "/onvif/device_service?ONVIFProfile=Profile1",
                topic: "/contoso/managementGroup1/action1",
                typeRef: "action1TypeRef",
                actionType: "Call",
                timeoutInSeconds: 60,
                lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
              },
              {
                name: "action2",
                actionConfiguration: '{"retryCount":5,"retryBackoffInterval":5}',
                targetUri: "/onvif/device_service?ONVIFProfile=Profile2",
                topic: "/contoso/managementGroup1/action2",
                typeRef: "action2TypeRef",
                actionType: "Call",
                timeoutInSeconds: 60,
                lastUpdatedOn: new Date("2024-04-09T14:20:00.52Z"),
              },
            ],
          },
        ],
      },
    },
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/my-namespace-1/discoveredAssets/my-discoveredasset-1",
  "name": "my-discoveredasset-1",
  "type": "Microsoft.DeviceRegistry/namespaces/discoveredAssets",
  "location": "West Europe",
  "extendedLocation": {
    "type": "CustomLocation",
    "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"
  },
  "tags": {
    "site": "building-1"
  },
  "systemData": {
    "createdBy": "2ta23112-4596-44ff-b773-19405922bfc1",
    "createdByType": "Application",
    "createdAt": "2022-11-16T00:36:43.2516899Z",
    "lastModifiedBy": "2ta23112-4596-44ff-b773-19405922bfc1",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2022-11-16T01:37:16.0922793Z"
  },
  "properties": {
    "deviceRef": {
      "deviceName": "myDevice",
      "endpointName": "opcuaendpointname"
    },
    "assetTypeRefs": [
      "myAssetTypeRef1",
      "myAssetTypeRef2"
    ],
    "discoveryId": "11111111-1111-1111-1111-111111111111",
    "version": 73766,
    "manufacturer": "Contoso",
    "manufacturerUri": "https://www.contoso.com/manufacturerUri",
    "model": "ContosoModel",
    "productCode": "SA34VDG",
    "hardwareRevision": "1.0",
    "softwareRevision": "2.0",
    "documentationUri": "https://www.example.com/manual",
    "serialNumber": "64-103816-519918-8",
    "attributes": {
      "floor": "1"
    },
    "defaultDatasetsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultEventsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultStreamsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultManagementGroupsConfiguration": "{\"retryCount\":10,\"retryBackoffInterval\":15}",
    "defaultDatasetsDestinations": [
      {
        "target": "BrokerStateStore",
        "configuration": {
          "key": "defaultValue"
        }
      }
    ],
    "defaultEventsDestinations": [
      {
        "target": "Storage",
        "configuration": {
          "path": "/tmp"
        }
      }
    ],
    "defaultStreamsDestinations": [
      {
        "target": "Mqtt",
        "configuration": {
          "topic": "/contoso/test",
          "retain": "Never",
          "qos": "Qos0",
          "ttl": 3600
        }
      }
    ],
    "datasets": [
      {
        "name": "dataset1",
        "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5",
        "typeRef": "dataset1TypeRef",
        "datasetConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "destinations": [
          {
            "target": "BrokerStateStore",
            "configuration": {
              "key": "dataset1"
            }
          }
        ],
        "dataPoints": [
          {
            "name": "dataset1DataPoint1",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
            "dataPointConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
            "typeRef": "dataset1DataPoint1TypeRef",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          },
          {
            "name": "dataset1DataPoint2",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
            "dataPointConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
            "typeRef": "dataset1DataPoint2TypeRef",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          }
        ]
      }
    ],
    "eventGroups": [
      {
        "name": "default",
        "events": [
          {
            "name": "event1",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
            "eventConfiguration": "{\"publishingInterval\":7,\"samplingInterval\":1,\"queueSize\":8}",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
            "destinations": [
              {
                "target": "Mqtt",
                "configuration": {
                  "topic": "/contoso/testEvent1",
                  "retain": "Keep",
                  "qos": "Qos0",
                  "ttl": 7200
                }
              }
            ],
            "typeRef": "event1Ref"
          },
          {
            "name": "event2",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
            "eventConfiguration": "{\"publishingInterval\":7,\"samplingInterval\":8,\"queueSize\":4}",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
            "destinations": [
              {
                "target": "Storage",
                "configuration": {
                  "path": "/tmp/event2"
                }
              }
            ],
            "typeRef": "event2Ref"
          }
        ]
      }
    ],
    "streams": [
      {
        "name": "stream1",
        "streamConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "typeRef": "stream1TypeRef",
        "destinations": [
          {
            "target": "Storage",
            "configuration": {
              "path": "/tmp/stream1"
            }
          }
        ]
      },
      {
        "name": "stream2",
        "streamConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "typeRef": "stream2TypeRef",
        "destinations": [
          {
            "target": "Mqtt",
            "configuration": {
              "topic": "/contoso/testStream2",
              "retain": "Never",
              "qos": "Qos0",
              "ttl": 7200
            }
          }
        ]
      }
    ],
    "managementGroups": [
      {
        "name": "managementGroup1",
        "managementGroupConfiguration": "{\"retryCount\":10,\"retryBackoffInterval\":15}",
        "typeRef": "managementGroup1TypeRef",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "defaultTopic": "/contoso/managementGroup1",
        "defaultTimeoutInSeconds": 100,
        "actions": [
          {
            "name": "action1",
            "actionConfiguration": "{\"retryCount\":5,\"retryBackoffInterval\":5}",
            "targetUri": "/onvif/device_service?ONVIFProfile=Profile1",
            "topic": "/contoso/managementGroup1/action1",
            "typeRef": "action1TypeRef",
            "actionType": "Call",
            "timeoutInSeconds": 60,
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          },
          {
            "name": "action2",
            "actionConfiguration": "{\"retryCount\":5,\"retryBackoffInterval\":5}",
            "targetUri": "/onvif/device_service?ONVIFProfile=Profile2",
            "topic": "/contoso/managementGroup1/action2",
            "typeRef": "action2TypeRef",
            "actionType": "Call",
            "timeoutInSeconds": 60,
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          }
        ]
      }
    ],
    "provisioningState": "Accepted"
  }
}

Stavový kód:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/my-namespace-1/discoveredAssets/my-discoveredasset-1",
  "name": "my-discoveredasset-1",
  "type": "Microsoft.DeviceRegistry/namespaces/discoveredAssets",
  "location": "West Europe",
  "extendedLocation": {
    "type": "CustomLocation",
    "name": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.extendedlocation/customlocations/location1"
  },
  "tags": {
    "site": "building-1"
  },
  "systemData": {
    "createdBy": "2ta23112-4596-44ff-b773-19405922bfc1",
    "createdByType": "Application",
    "createdAt": "2022-11-16T00:36:43.2516899Z",
    "lastModifiedBy": "2ta23112-4596-44ff-b773-19405922bfc1",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2022-11-16T01:37:16.0922793Z"
  },
  "properties": {
    "deviceRef": {
      "deviceName": "myDevice",
      "endpointName": "opcuaendpointname"
    },
    "assetTypeRefs": [
      "myAssetTypeRef1",
      "myAssetTypeRef2"
    ],
    "discoveryId": "11111111-1111-1111-1111-111111111111",
    "version": 73766,
    "manufacturer": "Contoso",
    "manufacturerUri": "https://www.contoso.com/manufacturerUri",
    "model": "ContosoModel",
    "productCode": "SA34VDG",
    "hardwareRevision": "1.0",
    "softwareRevision": "2.0",
    "documentationUri": "https://www.example.com/manual",
    "serialNumber": "64-103816-519918-8",
    "attributes": {
      "floor": "1"
    },
    "defaultDatasetsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultEventsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultStreamsConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
    "defaultManagementGroupsConfiguration": "{\"retryCount\":10,\"retryBackoffInterval\":15}",
    "defaultDatasetsDestinations": [
      {
        "target": "BrokerStateStore",
        "configuration": {
          "key": "defaultValue"
        }
      }
    ],
    "defaultEventsDestinations": [
      {
        "target": "Storage",
        "configuration": {
          "path": "/tmp"
        }
      }
    ],
    "defaultStreamsDestinations": [
      {
        "target": "Mqtt",
        "configuration": {
          "topic": "/contoso/test",
          "retain": "Never",
          "qos": "Qos0",
          "ttl": 3600
        }
      }
    ],
    "datasets": [
      {
        "name": "dataset1",
        "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5",
        "typeRef": "dataset1TypeRef",
        "datasetConfiguration": "{\"publishingInterval\":10,\"samplingInterval\":15,\"queueSize\":20}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "destinations": [
          {
            "target": "BrokerStateStore",
            "configuration": {
              "key": "dataset1"
            }
          }
        ],
        "dataPoints": [
          {
            "name": "dataset1DataPoint1",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
            "dataPointConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
            "typeRef": "dataset1DataPoint1TypeRef",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          },
          {
            "name": "dataset1DataPoint2",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
            "dataPointConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
            "typeRef": "dataset1DataPoint2TypeRef",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          }
        ]
      }
    ],
    "eventGroups": [
      {
        "name": "default",
        "events": [
          {
            "name": "event1",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt3",
            "eventConfiguration": "{\"publishingInterval\":7,\"samplingInterval\":1,\"queueSize\":8}",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
            "destinations": [
              {
                "target": "Mqtt",
                "configuration": {
                  "topic": "/contoso/testEvent1",
                  "retain": "Keep",
                  "qos": "Qos0",
                  "ttl": 7200
                }
              }
            ],
            "typeRef": "event1Ref"
          },
          {
            "name": "event2",
            "dataSource": "nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt4",
            "eventConfiguration": "{\"publishingInterval\":7,\"samplingInterval\":8,\"queueSize\":4}",
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
            "destinations": [
              {
                "target": "Storage",
                "configuration": {
                  "path": "/tmp/event2"
                }
              }
            ],
            "typeRef": "event2Ref"
          }
        ]
      }
    ],
    "streams": [
      {
        "name": "stream1",
        "streamConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "typeRef": "stream1TypeRef",
        "destinations": [
          {
            "target": "Storage",
            "configuration": {
              "path": "/tmp/stream1"
            }
          }
        ]
      },
      {
        "name": "stream2",
        "streamConfiguration": "{\"publishingInterval\":8,\"samplingInterval\":8,\"queueSize\":4}",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "typeRef": "stream2TypeRef",
        "destinations": [
          {
            "target": "Mqtt",
            "configuration": {
              "topic": "/contoso/testStream2",
              "retain": "Never",
              "qos": "Qos0",
              "ttl": 7200
            }
          }
        ]
      }
    ],
    "managementGroups": [
      {
        "name": "managementGroup1",
        "managementGroupConfiguration": "{\"retryCount\":10,\"retryBackoffInterval\":15}",
        "typeRef": "managementGroup1TypeRef",
        "lastUpdatedOn": "2024-04-09T14:20:00.52Z",
        "defaultTopic": "/contoso/managementGroup1",
        "defaultTimeoutInSeconds": 100,
        "actions": [
          {
            "name": "action1",
            "actionConfiguration": "{\"retryCount\":5,\"retryBackoffInterval\":5}",
            "targetUri": "/onvif/device_service?ONVIFProfile=Profile1",
            "topic": "/contoso/managementGroup1/action1",
            "typeRef": "action1TypeRef",
            "actionType": "Call",
            "timeoutInSeconds": 60,
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          },
          {
            "name": "action2",
            "actionConfiguration": "{\"retryCount\":5,\"retryBackoffInterval\":5}",
            "targetUri": "/onvif/device_service?ONVIFProfile=Profile2",
            "topic": "/contoso/managementGroup1/action2",
            "typeRef": "action2TypeRef",
            "actionType": "Call",
            "timeoutInSeconds": 60,
            "lastUpdatedOn": "2024-04-09T14:20:00.52Z"
          }
        ]
      }
    ],
    "provisioningState": "Accepted"
  }
}

Definice

Name	Description
BrokerStateStoreDestinationConfiguration	Konfigurace pro cíl úložiště stavů zprostředkovatele MQTT.
createdByType	Typ identity, která prostředek vytvořila.
DatasetBrokerStateStoreDestination	Typ cíle úložiště stavů zprostředkovatele MQTT.
DatasetDestinationTarget	Sada podporovaných cílů datových sad pro datový zdroj.
DatasetMqttDestination	Typ pro cíl MQTT.
DatasetStorageDestination	Typ cílového úložiště.
DeviceRef	Definuje, které zařízení a koncový bod se má pro tento prostředek použít
ErrorAdditionalInfo	Chyba správy zdrojů další informace.
ErrorDetail	Detail chyby.
ErrorResponse	Chybová odpověď
EventDestinationTarget	Sada podporovaných cílů událostí pro datový zdroj.
EventMqttDestination	Typ pro cíl MQTT.
EventStorageDestination	Typ cílového úložiště.
ExtendedLocation	Rozšířené umístění.
MqttDestinationConfiguration	Konfigurace pro cíl MQTT.
MqttDestinationQos	Nastavení MQTT QoS. Výchozí hodnota je QoS 1.
NamespaceDiscoveredAsset	Definice zjištěného datového zdroje.
NamespaceDiscoveredDataset	Definuje vlastnosti datové sady.
NamespaceDiscoveredDatasetDataPoint	Definuje vlastnosti zjištěného datového bodu datové sady.
NamespaceDiscoveredEvent	Definuje vlastnosti události.
NamespaceDiscoveredEventGroup	Definuje vlastnosti zjištěné skupiny událostí.
NamespaceDiscoveredManagementAction	Definuje vlastnosti akce.
NamespaceDiscoveredManagementActionType	Typ akce.
NamespaceDiscoveredManagementGroup	Definuje vlastnosti skupiny pro správu.
NamespaceDiscoveredStream	Definuje vlastnosti datového proudu.
ProvisioningState	Stav zřizování prostředku.
StorageDestinationConfiguration	Konfigurace cílového úložiště.
StreamDestinationTarget	Sada podporovaných cílů datových proudů pro datový zdroj.
StreamMqttDestination	Typ pro cíl MQTT.
StreamStorageDestination	Typ cílového úložiště.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TopicRetainType	Pokud je nastavená možnost Zachovat, zprávy publikované ve zprostředkovateli MQTT budou mít nastavené příznak zachování. Výchozí hodnota: Nikdy.

BrokerStateStoreDestinationConfiguration

Objekt

Konfigurace pro cíl úložiště stavů zprostředkovatele MQTT.

Name	Typ	Description
key	string	Cílový klíč úložiště stavů zprostředkovatele MQTT.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DatasetBrokerStateStoreDestination

Objekt

Typ cíle úložiště stavů zprostředkovatele MQTT.

Name	Typ	Description
configuration	BrokerStateStoreDestinationConfiguration	Konfigurace cílového úložiště stavů zprostředkovatele MQTT.
target	string: BrokerStateStore	Cílová destinace.

DatasetDestinationTarget

Výčet

Sada podporovaných cílů datových sad pro datový zdroj.

Hodnota	Description
Mqtt	MQTT terč.
BrokerStateStore	Cíl úložiště stavů brokera.
Storage	Cíl úložiště.

DatasetMqttDestination

Objekt

Typ pro cíl MQTT.

Name	Typ	Description
configuration	MqttDestinationConfiguration	Konfigurace MQTT destinace.
target	string: Mqtt	Cílová destinace.

DatasetStorageDestination

Objekt

Typ cílového úložiště.

Name	Typ	Description
configuration	StorageDestinationConfiguration	Konfigurace cíle úložiště.
target	string: Storage	Cílová destinace.

DeviceRef

Objekt

Definuje, které zařízení a koncový bod se má pro tento prostředek použít

Name	Typ	Description
deviceName	string	Název prostředku zařízení
endpointName	string	Název koncového bodu, který se má použít

ErrorAdditionalInfo

Objekt

Chyba správy zdrojů další informace.

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Detail chyby.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

EventDestinationTarget

Výčet

Sada podporovaných cílů událostí pro datový zdroj.

Hodnota	Description
Mqtt	MQTT terč.
Storage	Cíl úložiště.

EventMqttDestination

Objekt

Typ pro cíl MQTT.

Name	Typ	Description
configuration	MqttDestinationConfiguration	Konfigurace MQTT destinace.
target	string: Mqtt	Cílová destinace.

EventStorageDestination

Objekt

Typ cílového úložiště.

Name	Typ	Description
configuration	StorageDestinationConfiguration	Konfigurace cíle úložiště.
target	string: Storage	Cílová destinace.

ExtendedLocation

Objekt

Rozšířené umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	string	Typ rozšířeného umístění.

MqttDestinationConfiguration

Objekt

Konfigurace pro cíl MQTT.

Name	Typ	Default value	Description
qos	MqttDestinationQos	Qos1	Nastavení MQTT QoS. Výchozí hodnota je QoS 1.
retain	TopicRetainType	Never	Pokud je nastavená možnost Zachovat, zprávy publikované ve zprostředkovateli MQTT budou mít nastavené příznak zachování. Výchozí hodnota: Nikdy.
topic	string		Téma MQTT.
ttl	integer (int64)		Nastavení TTL MQTT.

MqttDestinationQos

Výčet

Nastavení MQTT QoS. Výchozí hodnota je QoS 1.

Hodnota	Description
Qos0	QoS 0.
Qos1	QoS 1.

NamespaceDiscoveredAsset

Objekt

Definice zjištěného datového zdroje.

Name	Typ	Description
extendedLocation	ExtendedLocation	Rozšířené umístění.
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.assetTypeRefs	string[]	Identifikátory URI nebo ID definic typů.
properties.attributes		Sada párů klíč-hodnota, které obsahují vlastní atributy.
properties.datasets	NamespaceDiscoveredDataset[]	Pole datových sad, které jsou součástí assetu. Každá specifikace datové sady popisuje datové body, které tvoří sadu.
properties.defaultDatasetsConfiguration	string	Řetězecifikovaný JSON, který obsahuje výchozí konfiguraci specifickou pro konektory pro všechny datové sady. Každá datová sada může mít vlastní konfiguraci, která zde přepíše výchozí nastavení.
properties.defaultDatasetsDestinations	DatasetDestination[]: DatasetBrokerStateStoreDestination[] DatasetMqttDestination[] DatasetStorageDestination[]	Výchozí cíle pro datovou sadu.
properties.defaultEventsConfiguration	string	Stringifikovaný JSON, který obsahuje výchozí konfiguraci specifickou pro konektory pro všechny události. Každá událost může mít vlastní konfiguraci, která zde přepíše výchozí nastavení.
properties.defaultEventsDestinations	EventDestination[]: EventMqttDestination[] EventStorageDestination[]	Výchozí cíle pro událost.
properties.defaultManagementGroupsConfiguration	string	Řetězec JSON, který obsahuje výchozí konfiguraci specifickou pro konektor pro všechny skupiny pro správu. Každá skupina pro správu může mít vlastní konfiguraci, která přepíše výchozí nastavení.
properties.defaultStreamsConfiguration	string	Řetězec JSON obsahující výchozí konfiguraci specifickou pro konektor pro všechny datové proudy. Každý datový proud může mít vlastní konfiguraci, která přepíše výchozí nastavení.
properties.defaultStreamsDestinations	StreamDestination[]: StreamMqttDestination[] StreamStorageDestination[]	Výchozí cíle pro stream.
properties.description	string	Popis aktiva čitelný pro člověka.
properties.deviceRef	DeviceRef	Odkaz na zařízení, které poskytuje data pro tento datový zdroj. Je nutné zadat název zařízení a koncový bod zařízení, které chcete použít.
properties.discoveryId	string	Identifikátor použitý k detekci změn v prostředku.
properties.displayName	string	Zobrazované jméno čitelné pro člověka.
properties.documentationUri	string	Referenční dokumentace k aktivům.
properties.eventGroups	NamespaceDiscoveredEventGroup[]	Pole skupin událostí, které jsou součástí datového zdroje. Každá skupina událostí může mít konfiguraci pro jednotlivé skupiny událostí.
properties.externalAssetId	string	ID datového zdroje poskytnuté zákazníkem.
properties.hardwareRevision	string	Číslo revize hardwaru datového zdroje.
properties.managementGroups	NamespaceDiscoveredManagementGroup[]	Pole skupin pro správu, které jsou součástí datového zdroje. Každá skupina pro správu může mít konfiguraci pro jednotlivé skupiny.
properties.manufacturer	string	Výrobce aktiv.
properties.manufacturerUri	string	Identifikátor URI výrobce majetku.
properties.model	string	Model datového zdroje.
properties.productCode	string	Kód produktu asset.
properties.provisioningState	ProvisioningState	Stav zřizování prostředku
properties.serialNumber	string	Sériové číslo aktiva.
properties.softwareRevision	string	Číslo revize softwaru Asset.
properties.streams	NamespaceDiscoveredStream[]	Pole datových proudů, které jsou součástí datového zdroje. Každý datový proud může mít konfiguraci pro jednotlivé datové proudy.
properties.version	integer (int64)	Celé číslo, které se zvýší při každé změně prostředku.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

NamespaceDiscoveredDataset

Objekt

Definuje vlastnosti datové sady.

Name	Typ	Description
dataPoints	NamespaceDiscoveredDatasetDataPoint[]	Pole datových bodů, které jsou součástí datové sady. Každý datový bod může mít konfiguraci jednotlivých datových bodů.
dataSource	string	Odkaz na zdroj dat pro danou datovou sadu.
datasetConfiguration	string	Stringifikovaný JSON obsahující vlastnosti specifické pro konektory, které popisují konfiguraci pro konkrétní datovou sadu.
destinations	DatasetDestination[]: DatasetBrokerStateStoreDestination[] DatasetMqttDestination[] DatasetStorageDestination[]	Cíle pro datovou sadu.
lastUpdatedOn	string (date-time)	Časové razítko (ve formátu UTC) označující, kdy byla datová sada přidána nebo změněna.
name	string	Název datové sady
typeRef	string	Identifikátor URI nebo ID definice typu.

NamespaceDiscoveredDatasetDataPoint

Objekt

Definuje vlastnosti zjištěného datového bodu datové sady.

Name	Typ	Description
dataPointConfiguration	string	Stringifikovaný JSON, který obsahuje konfiguraci specifickou pro konektor pro datový bod U OPC UA to může zahrnovat konfiguraci, jako je publikováníInterval, vzorkováníInterval a queueSize.
dataSource	string	Adresa zdroje dat v prostředku (např. ADRESA URL), aby klient mohl získat přístup ke zdroji dat na prostředku.
lastUpdatedOn	string (date-time)	Časové razítko UTC označující, kdy byl datový bod přidán nebo změněn.
name	string	Název datového bodu.
typeRef	string	Identifikátor URI nebo ID definice typu.

NamespaceDiscoveredEvent

Objekt

Definuje vlastnosti události.

Name	Typ	Description
dataSource	string	Odkaz na zdroj dat pro danou událost.
destinations	EventDestination[]: EventMqttDestination[] EventStorageDestination[]	Destinace pro událost.
eventConfiguration	string	Stringifikovaný JSON, který obsahuje konfiguraci specifickou pro konektor pro událost. U OPC UA to může zahrnovat konfiguraci, jako je publikováníInterval, vzorkováníInterval a queueSize.
lastUpdatedOn	string (date-time)	Časové razítko UTC označující, kdy byla událost přidána nebo změněna.
name	string	Název události.
typeRef	string	Identifikátor URI nebo ID definice typu.

NamespaceDiscoveredEventGroup

Objekt

Definuje vlastnosti zjištěné skupiny událostí.

Name	Typ	Description
dataSource	string	Adresa oznamovatele skupiny událostí v datovém zdroji (např. adresa URL), aby měl klient přístup ke skupině událostí v datovém zdroji.
defaultDestinations	EventDestination[]: EventMqttDestination[] EventStorageDestination[]	Destinace pro akce. Výchozí místa určení, pokud místa určení nejsou definována na úrovni události.
eventGroupConfiguration	string	Řetězec JSON , který obsahuje konfiguraci specifickou pro konektor pro skupinu událostí. U OPC UA to může zahrnovat konfiguraci, jako je publikováníInterval, vzorkováníInterval a queueSize.
events	NamespaceDiscoveredEvent[]	Pole událostí, které jsou součástí skupiny událostí.
name	string	Název skupiny událostí.
typeRef	string	Identifikátor URI nebo ID definice typu.

NamespaceDiscoveredManagementAction

Objekt

Definuje vlastnosti akce.

Name	Typ	Default value	Description
actionConfiguration	string		Řetězec JSON , který obsahuje konfiguraci specifickou pro konektor pro akci.
actionType	NamespaceDiscoveredManagementActionType	Call	Typ akce.
lastUpdatedOn	string (date-time)		Časové razítko (ve formátu UTC) označující, kdy byla akce správy přidána nebo změněna.
name	string		Název akce.
targetUri	string		Cílový identifikátor URI, na kterém může klient vyvolat konkrétní akci.
timeoutInSeconds	integer (int32)		Časový limit odezvy pro danou akci.
topic	string		Cesta k tématu MQTT, na kterém klient obdrží požadavek na akci.
typeRef	string		Identifikátor URI nebo ID definice typu.

NamespaceDiscoveredManagementActionType

Výčet

Typ akce.

Hodnota	Description
Call	Typ akce volání.
Read	Typ akce čtení.
Write	Typ akce zápisu.

NamespaceDiscoveredManagementGroup

Objekt

Definuje vlastnosti skupiny pro správu.

Name	Typ	Default value	Description
actions	NamespaceDiscoveredManagementAction[]		Pole akcí, které jsou součástí skupiny pro správu. Každá akce může mít individuální konfiguraci.
dataSource	string		Odkaz na zdroj dat pro danou skupinu pro správu.
defaultTimeoutInSeconds	integer (int32)	100	Výchozí časový limit odezvy pro všechny akce, které jsou součástí skupiny pro správu.
defaultTopic	string		Výchozí cesta tématu MQTT, na které klient obdrží požadavek na všechny akce, které jsou součástí skupiny pro správu.
lastUpdatedOn	string (date-time)		Časové razítko (ve formátu UTC) označující, kdy byla skupina pro správu přidána nebo změněna.
managementGroupConfiguration	string		Řetězec JSON obsahující konfiguraci specifickou pro konektor pro skupinu pro správu.
name	string		Název skupiny pro správu
typeRef	string		Identifikátor URI nebo ID definice typu.

NamespaceDiscoveredStream

Objekt

Definuje vlastnosti datového proudu.

Name	Typ	Description
destinations	StreamDestination[]: StreamMqttDestination[] StreamStorageDestination[]	Cíle pro stream.
lastUpdatedOn	string (date-time)	Časové razítko (ve formátu UTC) označující, kdy byl datový proud přidán nebo upraven.
name	string	Název definice datového proudu.
streamConfiguration	string	Řetězec JSON obsahující konfiguraci specifickou pro konektor pro konkrétní datový proud.
typeRef	string	Identifikátor URI nebo ID definice typu.

ProvisioningState

Výčet

Stav zřizování prostředku.

Hodnota	Description
Succeeded	Zdroj byl vytvořen.
Failed	Vytvoření zdroje se nezdařilo.
Canceled	Vytváření zdrojů bylo zrušeno.
Accepted	Zdroj byl serverem přijat.
Deleting	Prostředek se odstraňuje.

StorageDestinationConfiguration

Objekt

Konfigurace cílového úložiště.

Name	Typ	Description
path	string	Cílová cesta úložiště.

StreamDestinationTarget

Výčet

Sada podporovaných cílů datových proudů pro datový zdroj.

Hodnota	Description
Mqtt	MQTT terč.
Storage	Cíl úložiště.

StreamMqttDestination

Objekt

Typ pro cíl MQTT.

Name	Typ	Description
configuration	MqttDestinationConfiguration	Konfigurace MQTT destinace.
target	string: Mqtt	Cílová destinace.

StreamStorageDestination

Objekt

Typ cílového úložiště.

Name	Typ	Description
configuration	StorageDestinationConfiguration	Konfigurace cíle úložiště.
target	string: Storage	Cílová destinace.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TopicRetainType

Výčet

Pokud je nastavená možnost Zachovat, zprávy publikované ve zprostředkovateli MQTT budou mít nastavené příznak zachování. Výchozí hodnota: Nikdy.

Hodnota	Description
Keep	Zprávy uchovejte.
Never	Nikdy neuchovávejte zprávy.