az iot ops schema

Anteprima
Riferimento

Nota

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

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestione dello schema e del Registro di sistema.

Gli schemi sono documenti che descrivono i dati per abilitare l'elaborazione e la contestualizzazione. Gli schemi di messaggio descrivono il formato di un messaggio e il relativo contenuto. Per creare e gestire gli schemi, è necessario un Registro di sistema dello schema.

Comandi

Nome	Descrizione	Tipo	Status
az iot ops schema create	Creare uno schema all'interno di un registro schemi.	Estensione	Anteprima
az iot ops schema delete	Eliminare uno schema di destinazione all'interno di un registro schemi.	Estensione	Anteprima
az iot ops schema list	Elencare gli schemi all'interno di un registro schemi.	Estensione	Anteprima
az iot ops schema registry	Gestione del Registro di sistema dello schema.	Estensione	Anteprima
az iot ops schema registry create	Creare un registro schemi.	Estensione	Anteprima
az iot ops schema registry delete	Eliminare un Registro di sistema dello schema di destinazione.	Estensione	Anteprima
az iot ops schema registry list	Elencare i registri dello schema in un gruppo di risorse o in una sottoscrizione.	Estensione	Anteprima
az iot ops schema registry show	Visualizzare i dettagli di un Registro di sistema dello schema.	Estensione	Anteprima
az iot ops schema show	Visualizzare i dettagli di uno schema all'interno di un registro schemi.	Estensione	Anteprima
az iot ops schema show-dataflow-refs	Visualizzare i riferimenti allo schema usati per i flussi di dati.	Estensione	Sperimentale
az iot ops schema version	Gestione delle versioni dello schema.	Estensione	Anteprima
az iot ops schema version add	Aggiungere una versione dello schema a uno schema.	Estensione	Anteprima
az iot ops schema version list	Elencare le versioni dello schema per uno schema specifico.	Estensione	Anteprima
az iot ops schema version remove	Rimuovere una versione dello schema di destinazione.	Estensione	Anteprima
az iot ops schema version show	Mostra i dettagli di una versione dello schema.	Estensione	Anteprima

az iot ops schema create

Anteprima

Il gruppo di comandi 'iot ops schema' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare uno schema all'interno di un registro schemi.

Questa operazione richiede un Registro di sistema dello schema già creato e aggiungerà una versione dello schema. Per creare lo schema e aggiungere una versione, l'account di archiviazione associato dovrà avere l'accesso alla rete pubblica abilitato. Per altre informazioni sul formato di file delta, vedere aka.ms/lakehouse-delta-sample.

az iot ops schema create --format {delta, json}
                         --name
                         --registry
                         --resource-group
                         --type {message}
                         --vc
                         [--desc]
                         [--display-name]
                         [--vd]
                         [--ver]

Esempio

Creare uno schema denominato "myschema" nel Registro di sistema "myregistry" con input minimi. Lo schema versione 1 verrà creato per questo schema con il contenuto del file.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content myschema.json

Creare uno schema denominato "myschema" con personalizzazione aggiuntiva. Lo schema versione 14 verrà creato per questo schema. Il contenuto inline è un esempio di sintassi di PowerShell.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format delta --type message --desc "Schema for Assets" --display-name myassetschema --version-content '{\"hello\": \"world\"}' --ver 14 --vd "14th version"

Creare uno schema denominato "myschema". Lo schema versione 1 verrà creato per questo schema. Il contenuto inline è un esempio di sintassi cmd.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content "{\"hello\": \"world\"}"

Creare uno schema denominato "myschema". Lo schema versione 1 verrà creato per questo schema. Il contenuto inline è un esempio di sintassi bash.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content '{"hello": "world"}'

Parametri necessari

--format

Formato dello schema.

Valori accettati: delta, json

--name -n

Nome schema.

--registry

Nome del Registro di sistema dello schema.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--type

Tipo di schema.

Valori accettati: message

--vc --version-content

Percorso del file contenente o contenuto inline per la versione.

Parametri facoltativi

--desc

Descrizione dello schema.

--display-name

Nome visualizzato per lo schema.

--vd --version-desc

Descrizione per la versione.

--ver --version

Nome della versione dello schema.

Valore predefinito: 1

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az iot ops schema delete

Anteprima

Il gruppo di comandi 'iot ops schema' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare uno schema di destinazione all'interno di un registro schemi.

az iot ops schema delete --name
                         --registry
                         --resource-group
                         [--yes {false, true}]

Esempio

Eliminare uno schema di destinazione 'myschema' all'interno di un registro schemi 'myregistry'.

az iot ops schema delete --name myschema --registry myregistry -g myresourcegroup

Parametri necessari

--name -n

Nome schema.

--registry

Nome del Registro di sistema dello schema.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri facoltativi

--yes -y

Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.

Valori accettati: false, true

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az iot ops schema list

Anteprima

Il gruppo di comandi 'iot ops schema' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare gli schemi all'interno di un registro schemi.

az iot ops schema list --registry
                       --resource-group

Esempio

Elencare i registri dello schema nel Registro di sistema dello schema 'myregistry'.

az iot ops schema list -g myresourcegroup --registry myregistry

Parametri necessari

--registry

Nome del Registro di sistema dello schema.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az iot ops schema show

Anteprima

Il gruppo di comandi 'iot ops schema' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Visualizzare i dettagli di uno schema all'interno di un registro schemi.

az iot ops schema show --name
                       --registry
                       --resource-group

Esempio

Mostra i dettagli dello schema di destinazione 'myschema' all'interno di un registro schemi 'myregistry'.

az iot ops schema show --name myschema --registry myregistry -g myresourcegroup

Parametri necessari

--name -n

Nome schema.

--registry

Nome del Registro di sistema dello schema.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az iot ops schema show-dataflow-refs

Sperimentale

Questo comando è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Visualizzare i riferimenti allo schema usati per i flussi di dati.

az iot ops schema show-dataflow-refs --registry
                                     --resource-group
                                     [--latest {false, true}]
                                     [--schema]
                                     [--ver]

Esempio

Mostra informazioni di riferimento sullo schema per lo schema "myschema" e la versione 1.

az iot ops schema show-dataflow-refs --version 1 --schema myschema --registry myregistry -g myresourcegroup

Mostra informazioni di riferimento sullo schema per tutte le versioni nello schema "myschema".

az iot ops schema show-dataflow-refs --schema myschema --registry myregistry -g myresourcegroup

Mostra informazioni di riferimento sullo schema per tutte le versioni e gli schemi nel Registro di sistema dello schema "myregistry".

az iot ops schema show-dataflow-refs --registry myregistry -g myresourcegroup

Mostra informazioni di riferimento sullo schema per tutti gli schemi, ma solo le versioni più recenti nel Registro di sistema dello schema "myregistry".

az iot ops schema show-dataflow-refs --registry myregistry -g myresourcegroup --latest

Parametri necessari

--registry

Nome del Registro di sistema dello schema.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri facoltativi

--latest

Contrassegno per visualizzare solo le versioni più recenti.

Valori accettati: false, true

--schema

Nome schema. Obbligatorio se si usa --version.

--ver --version

Nome della versione dello schema. Se usato, --latest verrà ignorato.

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

Condividi tramite

az iot ops schema

Comandi

az iot ops schema create

Esempio

Parametri necessari

Parametri facoltativi

az iot ops schema delete

Esempio

Parametri necessari

Parametri facoltativi

az iot ops schema list

Esempio

Parametri necessari

az iot ops schema show

Esempio

Parametri necessari

az iot ops schema show-dataflow-refs

Esempio

Parametri necessari

Parametri facoltativi

Risorse aggiuntive