Condividi tramite

az iot ops schema registry

  • 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 registry . Altre informazioni sulle estensioni.

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

Gestione del Registro di sistema dello schema.

Un registro schemi è un repository centralizzato per la gestione degli schemi. Il Registro di sistema dello schema abilita la generazione e il recupero dello schema sia nel perimetro che nel cloud. Garantisce coerenza e compatibilità tra sistemi fornendo un'unica origine di verità per le definizioni dello schema.

Comandi

Nome Descrizione Tipo Status
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 registry 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 un registro schemi.

Questa operazione creerà un registro schemi con identità gestita di sistema abilitata.

Assegna quindi all'identità di sistema il ruolo predefinito "Collaboratore ai dati dei BLOB di archiviazione" rispetto all'ambito del contenitore dell'account di archiviazione per impostazione predefinita. Se necessario, è possibile fornire un ruolo personalizzato tramite --custom-role-id da usare.

Se il contenitore dell'account di archiviazione indicato non esiste, verrà creato con le impostazioni predefinite.

Questa operazione registrerà anche il provider di risorse Microsoft.DeviceRegistry se non è registrato.

az iot ops schema registry create --name
                                  --registry-namespace
                                  --resource-group
                                  --sa-resource-id
                                  [--custom-role-id]
                                  [--desc]
                                  [--display-name]
                                  [--location]
                                  [--sa-container]
                                  [--tags]

Esempio

Creare un registro schemi denominato "myregistry" con input minimi.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID

Creare un registro schemi denominato "myregistry" nell'area westus2 con una personalizzazione aggiuntiva.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID --sa-container myschemacontainer -l westus2 --desc 'Contoso factory X1 schemas' --display-name 'Contoso X1' --tags env=prod

Parametri necessari

--name -n

Nome del Registro di sistema dello schema.

--registry-namespace --rn

Spazio dei nomi del Registro di sistema dello schema. Identifica in modo univoco un registro schemi all'interno di un tenant.

--resource-group -g

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

--sa-resource-id

ID risorsa dell'account di archiviazione da usare con il Registro di sistema dello schema.

Parametri facoltativi

--custom-role-id

ID definizione del ruolo completo nel formato seguente: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

--desc

Descrizione per il Registro di sistema dello schema.

--display-name

Nome visualizzato per il Registro di sistema dello schema.

--location -l

Area per creare il Registro di sistema dello schema. Se non viene specificata alcuna posizione, verrà usata la posizione del gruppo di risorse.

--sa-container

Nome del contenitore dell'account di archiviazione in cui verranno archiviati gli schemi.

Valore predefinito: schemas
--tags

Tag del Registro di sistema dello schema. Contenitore delle proprietà in coppie chiave-valore con il formato seguente: a=b c=d. Usare --tags "" per rimuovere tutti i tag.

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 registry 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 un Registro di sistema dello schema di destinazione.

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

Esempio

Eliminare il Registro di sistema dello schema 'myregistry'.

az iot ops schema registry delete -n myregistry -g myresourcegroup

Parametri necessari

--name -n

Nome del Registro di sistema dello schema.

Parametri facoltativi

--resource-group -g

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

--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 registry 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 i registri dello schema in un gruppo di risorse o in una sottoscrizione.

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

Esempio

Elencare le registrazioni dello schema nel gruppo di risorse 'myresourcegroup'.

az iot ops schema registry list -g myresourcegroup

Elencare i registri dello schema nel filtro di sottoscrizione predefinito per un tag specifico.

az iot ops schema registry list --query "[?tags.env == 'prod']"

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È 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 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 registry 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 un Registro di sistema dello schema.

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

Esempio

Mostra i dettagli del Registro di sistema dello schema di destinazione 'myregistry'.

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

Parametri necessari

--name -n

Nome del Registro di sistema dello schema.

--resource-group -g

Nome del gruppo di risorse. È 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 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.