Partager via


az iot ops schema

Remarque

Cette référence fait partie de l’extension azure-iot-ops pour Azure CLI (version 2.53.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de schéma az iot ops. Apprenez-en davantage sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gestion des schémas et des registres.

Les schémas sont des documents qui décrivent les données pour permettre le traitement et la contextualisation. Les schémas de message décrivent le format d’un message et son contenu. Un registre de schémas est requis pour créer et gérer des schémas.

Commandes

Nom Description Type État
az iot ops schema create

Créez un schéma dans un registre de schémas.

Extension Aperçu
az iot ops schema delete

Supprimez un schéma cible dans un registre de schémas.

Extension Aperçu
az iot ops schema list

Répertorier les schémas dans un registre de schémas.

Extension Aperçu
az iot ops schema registry

Gestion du Registre de schémas.

Extension Aperçu
az iot ops schema registry create

Créez un registre de schémas.

Extension Aperçu
az iot ops schema registry delete

Supprimez un registre de schémas cible.

Extension Aperçu
az iot ops schema registry list

Répertorier les registres de schémas dans un groupe de ressources ou un abonnement.

Extension Aperçu
az iot ops schema registry show

Afficher les détails d’un registre de schémas.

Extension Aperçu
az iot ops schema show

Afficher les détails d’un schéma dans un registre de schémas.

Extension Aperçu
az iot ops schema show-dataflow-refs

Afficher les références de schéma utilisées pour les flux de données.

Extension Expérimental
az iot ops schema version

Gestion des versions de schéma.

Extension Aperçu
az iot ops schema version add

Ajoutez une version de schéma à un schéma.

Extension Aperçu
az iot ops schema version list

Répertorier les versions de schéma d’un schéma spécifique.

Extension Aperçu
az iot ops schema version remove

Supprimez une version de schéma cible.

Extension Aperçu
az iot ops schema version show

Afficher les détails d’une version de schéma.

Extension Aperçu

az iot ops schema create

Préversion

Le groupe de commandes « schéma iot ops » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créez un schéma dans un registre de schémas.

Cette opération nécessite un registre de schémas précréé et ajoute une version de schéma. Pour créer le schéma et ajouter une version, le compte de stockage associé doit avoir un accès réseau public activé. Pour plus d’informations sur le format de fichier delta, consultez 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]

Exemples

Créez un schéma appelé « myschema » dans le registre « myregistry » avec des entrées minimales. La version 1 du schéma sera créée pour ce schéma avec le contenu du fichier.

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

Créez un schéma appelé « myschema » avec une personnalisation supplémentaire. La version 14 du schéma sera créée pour ce schéma. Le contenu inline est un exemple de syntaxe 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"

Créez un schéma appelé « myschema ». La version 1 du schéma sera créée pour ce schéma. Le contenu inline est un exemple de syntaxe cmd.

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

Créez un schéma appelé « myschema ». La version 1 du schéma sera créée pour ce schéma. Le contenu inline est un exemple de syntaxe bash.

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

Paramètres obligatoires

--format

Format de schéma.

Valeurs acceptées: delta, json
--name -n

Nom du schéma.

--registry

Nom du registre de schémas.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--type

Type de schéma.

Valeurs acceptées: message
--vc --version-content

Chemin d’accès de fichier contenant ou contenu inline pour la version.

Paramètres facultatifs

--desc

Description du schéma.

--display-name

Nom complet du schéma.

--vd --version-desc

Description de la version.

--ver --version

Nom de la version du schéma.

Valeur par défaut: 1
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot ops schema delete

Préversion

Le groupe de commandes « schéma iot ops » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez un schéma cible dans un registre de schémas.

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

Exemples

Supprimez un schéma cible « myschema » dans un registre de schémas « myregistry ».

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

Paramètres obligatoires

--name -n

Nom du schéma.

--registry

Nom du registre de schémas.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

--yes -y

Confirmez [y]es sans invite. Utile pour les scénarios CI et Automation.

Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot ops schema list

Préversion

Le groupe de commandes « schéma iot ops » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les schémas dans un registre de schémas.

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

Exemples

Répertoriez les registres de schémas dans le registre de schémas « myregistry ».

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

Paramètres obligatoires

--registry

Nom du registre de schémas.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot ops schema show

Préversion

Le groupe de commandes « schéma iot ops » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Afficher les détails d’un schéma dans un registre de schémas.

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

Exemples

Affichez les détails du schéma cible « myschema » dans un registre de schémas « myregistry ».

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

Paramètres obligatoires

--name -n

Nom du schéma.

--registry

Nom du registre de schémas.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot ops schema show-dataflow-refs

Expérimental

Cette commande est expérimentale et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Afficher les références de schéma utilisées pour les flux de données.

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

Exemples

Afficher la référence de schéma pour le schéma « myschema » et la version 1.

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

Afficher la référence de schéma pour toutes les versions du schéma « myschema ».

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

Afficher la référence de schéma pour toutes les versions et schémas dans le registre de schémas « myregistry ».

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

Afficher la référence de schéma pour tous les schémas, mais uniquement les dernières versions du registre de schémas « myregistry ».

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

Paramètres obligatoires

--registry

Nom du registre de schémas.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

--latest

Indicateur pour afficher uniquement la ou les dernières versions.

Valeurs acceptées: false, true
--schema

Nom du schéma. Obligatoire si vous utilisez --version.

--ver --version

Nom de la version du schéma. Si elle est utilisée, --latest est ignoré.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.