az dt model

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az dt model . Altre informazioni sulle estensioni.

Gestire modelli e definizioni DTDL in un'istanza di Gemelli digitali.

Comandi

Nome Descrizione Tipo Stato
az dt model create

Carica uno o più modelli.

 Estensione Disponibilità generale
az dt model delete

Eliminare un modello. Un modello può essere eliminato solo se non vi fanno riferimento altri modelli.

 Estensione Disponibilità generale
az dt model delete-all

Eliminare tutti i modelli all'interno di un'istanza di Gemelli digitali.

 Estensione Disponibilità generale
az dt model list

Elencare metadati, definizioni e dipendenze del modello.

 Estensione Disponibilità generale
az dt model show

Recuperare un modello o una definizione di modello di destinazione.

 Estensione Disponibilità generale
az dt model update

Aggiorna i metadati per un modello. Attualmente un modello può essere decommisioned.

 Estensione Disponibilità generale

az dt model create

Carica uno o più modelli.

--models può essere inline json o percorso di file. Le dimensioni del set di modelli di input (ontologia) sono vincolate dal numero massimo di modelli che l'istanza DT può archiviare (il valore predefinito è 10000 modelli).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--max-models-per-batch]
                   [--models]
                   [--resource-group]

Esempio

Caricare in blocco tutti i file di modello .json o dtdl da una directory di destinazione. L'elaborazione del modello è ricorsiva.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

Caricare il file json del modello inline o dal percorso del file.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

Parametri facoltativi

--failure-policy --fp

Indica i criteri di errore quando si verifica un errore durante l'elaborazione di un batch di modelli. Nella modalità "Rollback" tutti i modelli creati nei batch precedenti vengono eliminati uno alla volta. Se questa opzione è selezionata come "Nessuno", i modelli creati nei batch precedenti non vengono eliminati dall'istanza DT.

valori accettati: None, Rollback
valore predefinito: Rollback
--fd --from-directory

I file del modello JSON della directory verranno analizzati. Nota: i modelli vengono creati in modo atomico quando la directory contiene 250 o modelli minori, pertanto in caso di errore non viene creato nessuno dei modelli. Il set di modelli di input è suddiviso in blocchi e creato in batch quando la directory ha più di 250 modelli(limite API). In caso di errore durante l'elaborazione di un batch, il comportamento è determinato dal parametro --failure-policy.

--max-models-per-batch --mmpb
Sperimentale

Dimensioni massime del modello per batch durante la creazione di più di 250 modelli. Ridurre questo numero per evitare un errore DTDLParser.

valore predefinito: 30
--models

Json del modello inline o percorso di file per il modello JSON. Nota: i modelli vengono creati in modo atomico quando il codice JSON del modello contiene 250 modelli minori, pertanto in caso di errore non viene creato nessuno dei modelli. Il set di modelli di input è suddiviso in blocchi e creato in batch quando json del modello ha più di 250 modelli(limite API). In caso di errore durante l'elaborazione di un batch, il comportamento è determinato dal parametro --failure-policy.

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az dt model delete

Eliminare un modello. Un modello può essere eliminato solo se non vi fanno riferimento altri modelli.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

Esempio

Eliminare un modello di destinazione.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

--dtmi --model-id -m

ID modello di Gemelli digitali. Esempio: dtmi:com:example:Room;2.

Parametri facoltativi

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az dt model delete-all

Eliminare tutti i modelli all'interno di un'istanza di Gemelli digitali.

Le configurazioni dei dispositivi gemelli non sono interessate, ma possono essere interrotte senza definizioni di modello.

az dt model delete-all --dt-name
                       [--resource-group]
                       [--yes]

Esempio

Eliminare tutti i modelli.

az dt model delete-all -n {instance_or_hostname}

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

Parametri facoltativi

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az dt model list

Elencare metadati, definizioni e dipendenze del modello.

az dt model list --dt-name
                 [--def {false, true}]
                 [--dependencies-for]
                 [--resource-group]

Esempio

Elencare i metadati del modello

az dt model list -n {instance_or_hostname}

Elencare le definizioni dei modelli

az dt model list -n {instance_or_hostname} --definition

Elencare le dipendenze di modelli preesistenti specifici. Spazia valori dtmi separati.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

Parametri facoltativi

--def --definition

L'operazione recupererà la definizione del modello.

valori accettati: false, true
valore predefinito: False
--dependencies-for

Set di modelli che avranno le relative dipendenze recuperate. Se omesso, vengono recuperati tutti i modelli. Format è un elenco separato da spazi vuoti.

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az dt model show

Recuperare un modello o una definizione di modello di destinazione.

az dt model show --dt-name
                 --dtmi
                 [--def {false, true}]
                 [--resource-group]

Esempio

Visualizzare i metadati del modello

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Visualizzare i metadati e la definizione del modello

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

--dtmi --model-id -m

ID modello di Gemelli digitali. Esempio: dtmi:com:example:Room;2.

Parametri facoltativi

--def --definition

L'operazione recupererà la definizione del modello.

valori accettati: false, true
valore predefinito: False
--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az dt model update

Aggiorna i metadati per un modello. Attualmente un modello può essere decommisioned.

az dt model update --dt-name
                   --dtmi
                   [--decommission {false, true}]
                   [--resource-group]

Esempio

Decomposizione di un modello di destinazione

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

Parametri necessari

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali o nome host. Se viene specificato un nome di istanza, la sottoscrizione utente viene prima di tutto eseguita una query per l'istanza di destinazione per recuperare il nome host. Se viene specificato un nome host, la query di sottoscrizione viene ignorata e il valore specificato viene usato per l'interazione successiva.

--dtmi --model-id -m

ID modello di Gemelli digitali. Esempio: dtmi:com:example:Room;2.

Parametri facoltativi

--decommission

Indica la finalità di rimuovere le autorizzazioni di un modello di destinazione.

valori accettati: false, true
--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.