Freigeben über


az iot ops schema

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-Schemabefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Schema- und Registrierungsverwaltung.

Schemas sind Dokumente, die Daten beschreiben, um die Verarbeitung und Kontextualisierung zu ermöglichen. Nachrichtenschemas beschreiben das Format einer Nachricht und des zugehörigen Inhalts. Zum Erstellen und Verwalten von Schemas ist eine Schemaregistrierung erforderlich.

Befehle

Name Beschreibung Typ Status
az iot ops schema create

Erstellen Sie ein Schema in einer Schemaregistrierung.

Erweiterung Vorschau
az iot ops schema delete

Löschen eines Zielschemas in einer Schemaregistrierung.

Erweiterung Vorschau
az iot ops schema list

Auflisten von Schemaschemas in einer Schemaregistrierung.

Erweiterung Vorschau
az iot ops schema registry

Schemaregistrierungsverwaltung.

Erweiterung Vorschau
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 show

Zeigen Sie Details eines Schemas in einer Schemaregistrierung an.

Erweiterung Vorschau
az iot ops schema show-dataflow-refs

Zeigen Sie die Schemaverweise an, die für Datenflüsse verwendet werden.

Erweiterung Experimentell
az iot ops schema version

Schemaversionsverwaltung.

Erweiterung Vorschau
az iot ops schema version add

Fügen Sie einem Schema eine Schemaversion hinzu.

Erweiterung Vorschau
az iot ops schema version list

Auflisten von Schemaversionen für ein bestimmtes Schema.

Erweiterung Vorschau
az iot ops schema version remove

Entfernen Sie eine Zielschemaversion.

Erweiterung Vorschau
az iot ops schema version show

Details einer Schemaversion anzeigen.

Erweiterung Vorschau

az iot ops schema create

Vorschau

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

Erstellen Sie ein Schema in einer Schemaregistrierung.

Für diesen Vorgang ist eine vorab erstellte Schemaregistrierung erforderlich und fügt eine Schemaversion hinzu. Um das Schema zu erstellen und eine Version hinzuzufügen, muss das zugeordnete Speicherkonto über aktivierten öffentlichen Netzwerkzugriff verfügen. Weitere Informationen zum Delta-Dateiformat finden Sie unter 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]

Beispiele

Erstellen Sie ein Schema namens "myschema" in der Registrierung "myregistry" mit minimalen Eingaben. Schemaversion 1 wird für dieses Schema mit dem Dateiinhalt erstellt.

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

Erstellen Sie ein Schema namens "myschema" mit zusätzlicher Anpassung. Schemaversion 14 wird für dieses Schema erstellt. Der Inlineinhalt ist ein PowerShell-Syntaxbeispiel.

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"

Erstellen Sie ein Schema namens "myschema". Schemaversion 1 wird für dieses Schema erstellt. Der Inlineinhalt ist ein Cmd-Syntaxbeispiel.

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

Erstellen Sie ein Schema namens "myschema". Schemaversion 1 wird für dieses Schema erstellt. Der Inlineinhalt ist ein Bash-Syntaxbeispiel.

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

Erforderliche Parameter

--format

Schemaformat.

Zulässige Werte: delta, json
--name -n

Schemaname.

--registry

Schemaregistrierungsname.

--resource-group -g

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

--type

Schematyp.

Zulässige Werte: message
--vc --version-content

Dateipfad, der Inhalte oder Inlineinhalte für die Version enthält.

Optionale Parameter

--desc

Beschreibung für das Schema.

--display-name

Anzeigename für das Schema.

--vd --version-desc

Beschreibung für die Version.

--ver --version

Schemaversionsname.

Standardwert: 1
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 delete

Vorschau

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

Löschen eines Zielschemas in einer Schemaregistrierung.

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

Beispiele

Löschen Sie ein Zielschema "myschema" in einer Schemaregistrierung "myregistry".

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

Erforderliche Parameter

--name -n

Schemaname.

--registry

Schemaregistrierungsname.

--resource-group -g

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

Optionale Parameter

--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 list

Vorschau

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

Auflisten von Schemaschemas in einer Schemaregistrierung.

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

Beispiele

Auflisten von Schemaregistern in der Schemaregistrierung "myregistry".

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

Erforderliche Parameter

--registry

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.

az iot ops schema show

Vorschau

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

Zeigen Sie Details eines Schemas in einer Schemaregistrierung an.

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

Beispiele

Zeigen Sie Details des Zielschemas "myschema" in einer Schemaregistrierung "myregistry" an.

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

Erforderliche Parameter

--name -n

Schemaname.

--registry

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.

az iot ops schema show-dataflow-refs

Experimentell

Dieser Befehl ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Zeigen Sie die Schemaverweise an, die für Datenflüsse verwendet werden.

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

Beispiele

Schemareferenz für Schema "myschema" und Version 1 anzeigen.

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

Schemareferenz für alle Versionen im Schema "myschema" anzeigen.

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

Schemareferenz für alle Versionen und Schemas in der Schemaregistrierung "myregistry" anzeigen.

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

Schemareferenz für alle Schemas anzeigen, aber nur die neuesten Versionen in der Schemaregistrierung "myregistry".

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

Erforderliche Parameter

--registry

Schemaregistrierungsname.

--resource-group -g

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

Optionale Parameter

--latest

Kennzeichnen, um nur die neuesten Versionen anzuzeigen.

Zulässige Werte: false, true
--schema

Schemaname. Erforderlich bei Verwendung von --version.

--ver --version

Schemaversionsname. Bei Verwendung wird --latest ignoriert.

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.