Freigeben über

az iot ops schema registry

  • Vorschau
  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-ops-Erweiterung für die Azure CLI (Version 2.53.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot ops-Schemaregistrierungsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Schemaregistrierungsverwaltung.

Eine Schemaregistrierung ist ein zentrales Repository zum Verwalten von Schemas. Die Schemaregistrierung ermöglicht die Schemagenerierung und das Abrufen sowohl am Edge als auch in der Cloud. Sie sorgt für Konsistenz und Kompatibilität in allen Systemen, indem eine einzige Wahrheitsquelle für Schemadefinitionen bereitgestellt wird.

Befehle

Name Beschreibung Typ Status
az iot ops schema registry create

Erstellen Sie eine Schemaregistrierung.

 Erweiterung Vorschau
az iot ops schema registry delete

Löschen sie eine Zielschemaregistrierung.

 Erweiterung Vorschau
az iot ops schema registry list

Auflisten von Schemaregistrierungen in einer Ressourcengruppe oder einem Abonnement.

 Erweiterung Vorschau
az iot ops schema registry show

Details einer Schemaregistrierung anzeigen.

 Erweiterung Vorschau

az iot ops schema registry create

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie eine Schemaregistrierung.

Dieser Vorgang erstellt eine Schemaregistrierung mit aktivierter systemverwalteter Identität.

Anschließend wird die Systemidentität standardmäßig der integrierten Rolle "Storage Blob Data Contributor" für den Containerbereich des Speicherkontos zugewiesen. Bei Bedarf können Sie stattdessen eine benutzerdefinierte Rolle über "--custom-role-id" bereitstellen.

Wenn der angegebene Speicherkontocontainer nicht vorhanden ist, wird er mit Standardeinstellungen erstellt.

Dieser Vorgang registriert auch den Microsoft.DeviceRegistry-Ressourcenanbieter, wenn er nicht registriert ist.

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

Beispiele

Erstellen Sie eine Schemaregistrierung mit dem Namen "myregistry" mit minimalen Eingaben.

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

Erstellen Sie eine Schemaregistrierung namens "myregistry" in region westus2 mit zusätzlicher Anpassung.

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

Erforderliche Parameter

--name -n

Schemaregistrierungsname.

--registry-namespace --rn

Schemaregistrierungsnamespace. Identifiziert eine Schemaregistrierung innerhalb eines Mandanten eindeutig.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sa-resource-id

Speicherkontoressourcen-ID, die mit der Schemaregistrierung verwendet werden soll.

Optionale Parameter

--custom-role-id

Vollqualifizierte Rollendefinitions-ID im folgenden Format: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

--desc

Beschreibung für die Schemaregistrierung.

--display-name

Anzeigename für die Schemaregistrierung.

--location -l

Region zum Erstellen der Schemaregistrierung. Wenn kein Speicherort bereitgestellt wird, wird der Speicherort der Ressourcengruppe verwendet.

--sa-container

Name des Speicherkontocontainers, in dem Schemas gespeichert werden.

Standardwert: schemas
--tags

Schemaregistrierungstags. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d. Verwenden Sie "-tags", um alle Tags zu entfernen.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops schema registry delete

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen sie eine Zielschemaregistrierung.

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

Beispiele

Löschen Sie die Schemaregistrierung "myregistry".

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

Erforderliche Parameter

--name -n

Schemaregistrierungsname.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Bestätigen Sie [y]es ohne Aufforderung. Nützlich für CI- und Automatisierungsszenarien.

Zulässige Werte: false, true
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops schema registry list

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten von Schemaregistrierungen in einer Ressourcengruppe oder einem Abonnement.

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

Beispiele

Listenschemaregister in der Ressourcengruppe "myresourcegroup" auf.

az iot ops schema registry list -g myresourcegroup

Listen von Schemaregistern in der Standardabonnementfilterung für ein bestimmtes Tag.

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

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops schema registry show

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Details einer Schemaregistrierung anzeigen.

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

Beispiele

Details der Zielschemaregistrierung "myregistry" anzeigen.

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

Erforderliche Parameter

--name -n

Schemaregistrierungsname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.