Risorse di Microsoft.DeviceRegistry

Definizione della risorsa Bicep

Il tipo di risorsa asset può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DeviceRegistry/assets, aggiungi il seguente Bicep al tuo template.

resource symbolicname 'Microsoft.DeviceRegistry/assets@2026-11-02-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    assetEndpointProfileRef: 'string'
    attributes: {
      {customized property}: any(...)
    }
    datasets: [
      {
        dataPoints: [
          {
            dataPointConfiguration: 'string'
            dataSource: 'string'
            name: 'string'
            observabilityMode: 'string'
          }
        ]
        datasetConfiguration: 'string'
        name: 'string'
        topic: {
          path: 'string'
          retain: 'string'
        }
      }
    ]
    defaultDatasetsConfiguration: 'string'
    defaultEventsConfiguration: 'string'
    defaultTopic: {
      path: 'string'
      retain: 'string'
    }
    description: 'string'
    discoveredAssetRefs: [
      'string'
    ]
    displayName: 'string'
    documentationUri: 'string'
    enabled: bool
    events: [
      {
        eventConfiguration: 'string'
        eventNotifier: 'string'
        name: 'string'
        observabilityMode: 'string'
        topic: {
          path: 'string'
          retain: 'string'
        }
      }
    ]
    externalAssetId: 'string'
    hardwareRevision: 'string'
    manufacturer: 'string'
    manufacturerUri: 'string'
    model: 'string'
    productCode: 'string'
    serialNumber: 'string'
    softwareRevision: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Microsoft.DeviceRegistry/assets

Name Description Value
extendedLocation Posizione estesa. ExtendedLocation (obbligatorio)
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (obbligatorio)
properties Proprietà specifiche della risorsa. AssetProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

AssetProperties

Name Description Value
assetEndpointProfileRef Riferimento al profilo dell'endpoint asset (informazioni di connessione) usato dai broker per connettersi a un endpoint che fornisce punti dati per questo asset. Specificare il nome del profilo dell'endpoint dell'asset. stringa (obbligatorio)
attributes Set di coppie chiave-valore che contengono attributi personalizzati impostati dal cliente. AssetPropertiesAttributes
datasets Matrice di set di dati che fanno parte dell'asset. Ogni set di dati descrive i punti dati che costituiscono il set. Dataset[]
defaultDatasetsConfiguration JSON stringato che contiene la configurazione predefinita specifica del connettore per tutti i set di dati. Ogni set di dati può avere una propria configurazione che esegue l'override delle impostazioni predefinite qui. string
defaultEventsConfiguration JSON stringato che contiene la configurazione predefinita specifica del connettore per tutti gli eventi. Ogni evento può avere una propria configurazione che esegue l'override delle impostazioni predefinite qui. string
defaultTopic Oggetto che descrive le informazioni sull'argomento predefinito per l'asset. Topic
description Descrizione leggibile dell'asset. string
discoveredAssetRefs Riferimento a un elenco di asset individuati. Popolato solo se l'asset è stato creato dal flusso di individuazione. È necessario specificare i nomi degli asset individuati. string[]
displayName Nome visualizzato leggibile. string
documentationUri Riferimento alla documentazione. string
enabled Stato abilitato/disabilitato dell'asset. bool
events Matrice di eventi che fanno parte dell'asset. Ogni evento può avere una configurazione per evento. Event[]
externalAssetId ID risorsa fornito dal cliente. string
hardwareRevision Numero di revisione dell'hardware. string
manufacturer Nome produttore asset. string
manufacturerUri URI del produttore di asset. string
model Nome del modello di asset. string
productCode Codice prodotto asset. string
serialNumber Numero di serie dell'asset. string
softwareRevision Numero di revisione del software. string

AssetPropertiesAttributes

Name Description Value

DataPoint

Name Description Value
dataPointConfiguration JSON stringato che contiene la configurazione specifica del connettore per il punto dati. Per OPC UA, può includere la configurazione, ad esempio publishingInterval, samplingInterval e queueSize. string
dataSource Indirizzo dell'origine dei dati nell'asset ,ad esempio URL, in modo che un client possa accedere all'origine dati nell'asset. stringa (obbligatorio)
name Nome del punto dati. stringa (obbligatorio)
observabilityMode Indicazione della modalità di mapping del punto dati a OpenTelemetry. 'Counter'
'Gauge'
'Histogram'
'Log'
'None'

Dataset

Name Description Value
dataPoints Matrice di punti dati che fanno parte del set di dati. Ogni punto dati può avere una configurazione per punto dati. DataPoint[]
datasetConfiguration JSON stringato che contiene una stringa JSON specifica del connettore che descrive la configurazione per il set di dati specifico. string
name Nome del set di dati. stringa (obbligatorio)
topic Oggetto che descrive le informazioni sull'argomento per il set di dati specifico. Topic

Event

Name Description Value
eventConfiguration JSON stringato che contiene la configurazione specifica del connettore per l'evento. Per OPC UA, può includere la configurazione, ad esempio publishingInterval, samplingInterval e queueSize. string
eventNotifier Indirizzo del notifier dell'evento nell'asset (ad esempio URL) in modo che un client possa accedere all'evento sull'asset. stringa (obbligatorio)
name Nome dell'evento. stringa (obbligatorio)
observabilityMode Indicazione della modalità di mapping dell'evento a OpenTelemetry. 'Log'
'None'
topic Oggetto che descrive le informazioni sull'argomento per l'evento specifico. Topic

ExtendedLocation

Name Description Value
name Nome della posizione estesa. stringa (obbligatorio)
type Tipo di posizione estesa. stringa (obbligatorio)

Topic

Name Description Value
path Percorso dell'argomento per i messaggi pubblicati in un broker MQTT. stringa (obbligatorio)
retain Se impostato su "Mantieni", i messaggi pubblicati in un broker MQTT avranno il flag di conservazione impostato. Impostazione predefinita: 'Never'. 'Keep'
'Never'

TrackedResourceTags

Name Description Value

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa asset può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Formato risorsa

Per creare una risorsa Microsoft.DeviceRegistry/assets, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.DeviceRegistry/assets",
  "apiVersion": "2026-11-02-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "assetEndpointProfileRef": "string",
    "attributes": {
      "{customized property}": {}
    },
    "datasets": [
      {
        "dataPoints": [
          {
            "dataPointConfiguration": "string",
            "dataSource": "string",
            "name": "string",
            "observabilityMode": "string"
          }
        ],
        "datasetConfiguration": "string",
        "name": "string",
        "topic": {
          "path": "string",
          "retain": "string"
        }
      }
    ],
    "defaultDatasetsConfiguration": "string",
    "defaultEventsConfiguration": "string",
    "defaultTopic": {
      "path": "string",
      "retain": "string"
    },
    "description": "string",
    "discoveredAssetRefs": [ "string" ],
    "displayName": "string",
    "documentationUri": "string",
    "enabled": "bool",
    "events": [
      {
        "eventConfiguration": "string",
        "eventNotifier": "string",
        "name": "string",
        "observabilityMode": "string",
        "topic": {
          "path": "string",
          "retain": "string"
        }
      }
    ],
    "externalAssetId": "string",
    "hardwareRevision": "string",
    "manufacturer": "string",
    "manufacturerUri": "string",
    "model": "string",
    "productCode": "string",
    "serialNumber": "string",
    "softwareRevision": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Microsoft.DeviceRegistry/assets

Name Description Value
apiVersion Versione dell'API 'anteprima 2026-11-02-preview'
extendedLocation Posizione estesa. ExtendedLocation (obbligatorio)
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (obbligatorio)
properties Proprietà specifiche della risorsa. AssetProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.DeviceRegistry/assets'

AssetProperties

Name Description Value
assetEndpointProfileRef Riferimento al profilo dell'endpoint asset (informazioni di connessione) usato dai broker per connettersi a un endpoint che fornisce punti dati per questo asset. Specificare il nome del profilo dell'endpoint dell'asset. stringa (obbligatorio)
attributes Set di coppie chiave-valore che contengono attributi personalizzati impostati dal cliente. AssetPropertiesAttributes
datasets Matrice di set di dati che fanno parte dell'asset. Ogni set di dati descrive i punti dati che costituiscono il set. Dataset[]
defaultDatasetsConfiguration JSON stringato che contiene la configurazione predefinita specifica del connettore per tutti i set di dati. Ogni set di dati può avere una propria configurazione che esegue l'override delle impostazioni predefinite qui. string
defaultEventsConfiguration JSON stringato che contiene la configurazione predefinita specifica del connettore per tutti gli eventi. Ogni evento può avere una propria configurazione che esegue l'override delle impostazioni predefinite qui. string
defaultTopic Oggetto che descrive le informazioni sull'argomento predefinito per l'asset. Topic
description Descrizione leggibile dell'asset. string
discoveredAssetRefs Riferimento a un elenco di asset individuati. Popolato solo se l'asset è stato creato dal flusso di individuazione. È necessario specificare i nomi degli asset individuati. string[]
displayName Nome visualizzato leggibile. string
documentationUri Riferimento alla documentazione. string
enabled Stato abilitato/disabilitato dell'asset. bool
events Matrice di eventi che fanno parte dell'asset. Ogni evento può avere una configurazione per evento. Event[]
externalAssetId ID risorsa fornito dal cliente. string
hardwareRevision Numero di revisione dell'hardware. string
manufacturer Nome produttore asset. string
manufacturerUri URI del produttore di asset. string
model Nome del modello di asset. string
productCode Codice prodotto asset. string
serialNumber Numero di serie dell'asset. string
softwareRevision Numero di revisione del software. string

AssetPropertiesAttributes

Name Description Value

DataPoint

Name Description Value
dataPointConfiguration JSON stringato che contiene la configurazione specifica del connettore per il punto dati. Per OPC UA, può includere la configurazione, ad esempio publishingInterval, samplingInterval e queueSize. string
dataSource Indirizzo dell'origine dei dati nell'asset ,ad esempio URL, in modo che un client possa accedere all'origine dati nell'asset. stringa (obbligatorio)
name Nome del punto dati. stringa (obbligatorio)
observabilityMode Indicazione della modalità di mapping del punto dati a OpenTelemetry. 'Counter'
'Gauge'
'Histogram'
'Log'
'None'

Dataset

Name Description Value
dataPoints Matrice di punti dati che fanno parte del set di dati. Ogni punto dati può avere una configurazione per punto dati. DataPoint[]
datasetConfiguration JSON stringato che contiene una stringa JSON specifica del connettore che descrive la configurazione per il set di dati specifico. string
name Nome del set di dati. stringa (obbligatorio)
topic Oggetto che descrive le informazioni sull'argomento per il set di dati specifico. Topic

Event

Name Description Value
eventConfiguration JSON stringato che contiene la configurazione specifica del connettore per l'evento. Per OPC UA, può includere la configurazione, ad esempio publishingInterval, samplingInterval e queueSize. string
eventNotifier Indirizzo del notifier dell'evento nell'asset (ad esempio URL) in modo che un client possa accedere all'evento sull'asset. stringa (obbligatorio)
name Nome dell'evento. stringa (obbligatorio)
observabilityMode Indicazione della modalità di mapping dell'evento a OpenTelemetry. 'Log'
'None'
topic Oggetto che descrive le informazioni sull'argomento per l'evento specifico. Topic

ExtendedLocation

Name Description Value
name Nome della posizione estesa. stringa (obbligatorio)
type Tipo di posizione estesa. stringa (obbligatorio)

Topic

Name Description Value
path Percorso dell'argomento per i messaggi pubblicati in un broker MQTT. stringa (obbligatorio)
retain Se impostato su "Mantieni", i messaggi pubblicati in un broker MQTT avranno il flag di conservazione impostato. Impostazione predefinita: 'Never'. 'Keep'
'Never'

TrackedResourceTags

Name Description Value

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa asset può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DeviceRegistry/assets, aggiungere il formato Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DeviceRegistry/assets@2026-11-02-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      assetEndpointProfileRef = "string"
      attributes = {
        {customized property} = ?
      }
      datasets = [
        {
          dataPoints = [
            {
              dataPointConfiguration = "string"
              dataSource = "string"
              name = "string"
              observabilityMode = "string"
            }
          ]
          datasetConfiguration = "string"
          name = "string"
          topic = {
            path = "string"
            retain = "string"
          }
        }
      ]
      defaultDatasetsConfiguration = "string"
      defaultEventsConfiguration = "string"
      defaultTopic = {
        path = "string"
        retain = "string"
      }
      description = "string"
      discoveredAssetRefs = [
        "string"
      ]
      displayName = "string"
      documentationUri = "string"
      enabled = bool
      events = [
        {
          eventConfiguration = "string"
          eventNotifier = "string"
          name = "string"
          observabilityMode = "string"
          topic = {
            path = "string"
            retain = "string"
          }
        }
      ]
      externalAssetId = "string"
      hardwareRevision = "string"
      manufacturer = "string"
      manufacturerUri = "string"
      model = "string"
      productCode = "string"
      serialNumber = "string"
      softwareRevision = "string"
    }
  }
}

Valori delle proprietà

Microsoft.DeviceRegistry/assets

Name Description Value
extendedLocation Posizione estesa. ExtendedLocation (obbligatorio)
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (obbligatorio)
properties Proprietà specifiche della risorsa. AssetProperties
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft. RegistroDispositivo/assets@2026-11-02-anteprima"

AssetProperties

Name Description Value
assetEndpointProfileRef Riferimento al profilo dell'endpoint asset (informazioni di connessione) usato dai broker per connettersi a un endpoint che fornisce punti dati per questo asset. Specificare il nome del profilo dell'endpoint dell'asset. stringa (obbligatorio)
attributes Set di coppie chiave-valore che contengono attributi personalizzati impostati dal cliente. AssetPropertiesAttributes
datasets Matrice di set di dati che fanno parte dell'asset. Ogni set di dati descrive i punti dati che costituiscono il set. Dataset[]
defaultDatasetsConfiguration JSON stringato che contiene la configurazione predefinita specifica del connettore per tutti i set di dati. Ogni set di dati può avere una propria configurazione che esegue l'override delle impostazioni predefinite qui. string
defaultEventsConfiguration JSON stringato che contiene la configurazione predefinita specifica del connettore per tutti gli eventi. Ogni evento può avere una propria configurazione che esegue l'override delle impostazioni predefinite qui. string
defaultTopic Oggetto che descrive le informazioni sull'argomento predefinito per l'asset. Topic
description Descrizione leggibile dell'asset. string
discoveredAssetRefs Riferimento a un elenco di asset individuati. Popolato solo se l'asset è stato creato dal flusso di individuazione. È necessario specificare i nomi degli asset individuati. string[]
displayName Nome visualizzato leggibile. string
documentationUri Riferimento alla documentazione. string
enabled Stato abilitato/disabilitato dell'asset. bool
events Matrice di eventi che fanno parte dell'asset. Ogni evento può avere una configurazione per evento. Event[]
externalAssetId ID risorsa fornito dal cliente. string
hardwareRevision Numero di revisione dell'hardware. string
manufacturer Nome produttore asset. string
manufacturerUri URI del produttore di asset. string
model Nome del modello di asset. string
productCode Codice prodotto asset. string
serialNumber Numero di serie dell'asset. string
softwareRevision Numero di revisione del software. string

AssetPropertiesAttributes

Name Description Value

DataPoint

Name Description Value
dataPointConfiguration JSON stringato che contiene la configurazione specifica del connettore per il punto dati. Per OPC UA, può includere la configurazione, ad esempio publishingInterval, samplingInterval e queueSize. string
dataSource Indirizzo dell'origine dei dati nell'asset ,ad esempio URL, in modo che un client possa accedere all'origine dati nell'asset. stringa (obbligatorio)
name Nome del punto dati. stringa (obbligatorio)
observabilityMode Indicazione della modalità di mapping del punto dati a OpenTelemetry. 'Counter'
'Gauge'
'Histogram'
'Log'
'None'

Dataset

Name Description Value
dataPoints Matrice di punti dati che fanno parte del set di dati. Ogni punto dati può avere una configurazione per punto dati. DataPoint[]
datasetConfiguration JSON stringato che contiene una stringa JSON specifica del connettore che descrive la configurazione per il set di dati specifico. string
name Nome del set di dati. stringa (obbligatorio)
topic Oggetto che descrive le informazioni sull'argomento per il set di dati specifico. Topic

Event

Name Description Value
eventConfiguration JSON stringato che contiene la configurazione specifica del connettore per l'evento. Per OPC UA, può includere la configurazione, ad esempio publishingInterval, samplingInterval e queueSize. string
eventNotifier Indirizzo del notifier dell'evento nell'asset (ad esempio URL) in modo che un client possa accedere all'evento sull'asset. stringa (obbligatorio)
name Nome dell'evento. stringa (obbligatorio)
observabilityMode Indicazione della modalità di mapping dell'evento a OpenTelemetry. 'Log'
'None'
topic Oggetto che descrive le informazioni sull'argomento per l'evento specifico. Topic

ExtendedLocation

Name Description Value
name Nome della posizione estesa. stringa (obbligatorio)
type Tipo di posizione estesa. stringa (obbligatorio)

Topic

Name Description Value
path Percorso dell'argomento per i messaggi pubblicati in un broker MQTT. stringa (obbligatorio)
retain Se impostato su "Mantieni", i messaggi pubblicati in un broker MQTT avranno il flag di conservazione impostato. Impostazione predefinita: 'Never'. 'Keep'
'Never'

TrackedResourceTags

Name Description Value