Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Definizione della risorsa Bicep
Il tipo di risorsa asset può essere distribuito con operazioni destinate a:
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:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
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 |
|---|