az dt model

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az dt model . En savoir plus sur les extensions.

Gérez les modèles et définitions DTDL sur une instance Digital Twins.

Commandes

Nom	Description	Type	Statut
az dt model create	Charge un ou plusieurs modèles.	Extension	GA
az dt model delete	Supprimer un modèle. Un modèle ne peut être supprimé que si aucun autre modèle ne le référence.	Extension	GA
az dt model delete-all	Supprimez tous les modèles d’une instance Digital Twins.	Extension	GA
az dt model list	Répertorier les métadonnées du modèle, les définitions et les dépendances.	Extension	GA
az dt model show	Récupérez un modèle cible ou une définition de modèle.	Extension	GA
az dt model update	Met à jour les métadonnées d’un modèle. Actuellement, un modèle ne peut être décommisionné que.	Extension	GA

az dt model create

Charge un ou plusieurs modèles.

--models peut être inline json ou chemin d’accès de fichier. La taille du jeu de modèles d’entrée (ontologie) est limitée par le nombre maximal de modèles que l’instance DT peut stocker (la valeur par défaut est de 1 000 modèles).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--max-models-per-batch]
                   [--models]
                   [--resource-group]

Exemples

Chargez en bloc tous les fichiers de modèle .json ou .dtdl à partir d’un répertoire cible. Le traitement du modèle est récursif.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

Chargez le modèle json inline ou à partir du chemin d’accès au fichier.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

Paramètres facultatifs

--failure-policy --fp

Indique la stratégie d’échec lorsqu’une erreur se produit lors du traitement d’un lot de modèles. Dans le mode « Restauration » tous les modèles créés dans les lots précédents sont supprimés un par un. Lorsqu’ils sont sélectionnés en tant que « Aucun » les modèles créés dans les lots précédents ne sont pas supprimés de l’instance DT.

valeurs acceptées: None, Rollback

valeur par défaut: Rollback

--fd --from-directory

Les fichiers de modèle JSON du répertoire sont analysés à partir de. Remarque : Les modèles sont créés atomiquement lorsque le répertoire contient 250 modèles ou moins, par conséquent, en cas d’erreur aucune des modèles n’est créée. L’ensemble de modèles d’entrée est segmenté et créé par lots lorsque le répertoire a plus de 250 modèles (limite d’API). En cas d’erreur lors du traitement d’un lot, le comportement est déterminé par le paramètre --failure-policy.

--max-models-per-batch --mmpb

Expérimental

Taille maximale du modèle par lot lors de la création de plus de 250 modèles. Réduisez ce nombre pour empêcher une erreur DTDLParser.

valeur par défaut: 30

--models

Json de modèle inline ou chemin d’accès de fichier au modèle JSON. Remarque : Les modèles sont créés atomiquement lorsque le modèle JSON contient 250 modèles ou moins, par conséquent, en cas d’erreur aucune des modèles n’est créée. L’ensemble de modèles d’entrée est segmenté et créé par lots lorsque le modèle JSON a plus de 250 modèles (limite d’API). En cas d’erreur lors du traitement d’un lot, le comportement est déterminé par le paramètre --failure-policy.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant 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 dt model delete

Supprimer un modèle. Un modèle ne peut être supprimé que si aucun autre modèle ne le référence.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

Exemples

Supprimez un modèle cible.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

--dtmi --model-id -m

ID de modèle Digital Twins. Exemple : dtmi :com :example :Room ;2.

Paramètres facultatifs

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant 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 dt model delete-all

Supprimez tous les modèles d’une instance Digital Twins.

Les configurations de jumeaux ne sont pas affectées, mais peuvent être rompues sans définitions de modèle.

az dt model delete-all --dt-name
                       [--resource-group]
                       [--yes]

Exemples

Supprimez tous les modèles.

az dt model delete-all -n {instance_or_hostname}

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

Paramètres facultatifs

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

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

Répertorier les métadonnées du modèle, les définitions et les dépendances.

az dt model list --dt-name
                 [--def {false, true}]
                 [--dependencies-for]
                 [--resource-group]

Exemples

Répertorier les métadonnées du modèle

az dt model list -n {instance_or_hostname}

Définitions de modèle de liste

az dt model list -n {instance_or_hostname} --definition

Répertorier les dépendances d’un ou plusieurs modèles préexistants particuliers. Valeurs dtmi distinctes d’espace.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

Paramètres facultatifs

--def --definition

L’opération récupère la définition du modèle.

valeurs acceptées: false, true

valeur par défaut: False

--dependencies-for

Ensemble de modèles qui auront leurs dépendances récupérées. S’il est omis, tous les modèles sont récupérés. Le format est une liste séparée par des espaces blancs.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant 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 dt model show

Récupérez un modèle cible ou une définition de modèle.

az dt model show --dt-name
                 --dtmi
                 [--def {false, true}]
                 [--resource-group]

Exemples

Afficher les métadonnées de modèle

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Afficher les métadonnées de modèle et la définition

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

--dtmi --model-id -m

ID de modèle Digital Twins. Exemple : dtmi :com :example :Room ;2.

Paramètres facultatifs

--def --definition

L’opération récupère la définition du modèle.

valeurs acceptées: false, true

valeur par défaut: False

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant 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 dt model update

Met à jour les métadonnées d’un modèle. Actuellement, un modèle ne peut être décommisionné que.

az dt model update --dt-name
                   --dtmi
                   [--decommission {false, true}]
                   [--resource-group]

Exemples

Décommision d’un modèle cible

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

Paramètres obligatoires

--dt-name --dtn -n

Nom d’instance Digital Twins ou nom d’hôte. Si un nom d’instance est fourni, l’abonnement utilisateur est interrogé pour la première fois pour que l’instance cible récupère le nom d’hôte. Si un nom d’hôte est fourni, la requête d’abonnement est ignorée et la valeur fournie est utilisée pour une interaction ultérieure.

--dtmi --model-id -m

ID de modèle Digital Twins. Exemple : dtmi :com :example :Room ;2.

Paramètres facultatifs

--decommission

Indique l’intention de désactiver un modèle cible.

valeurs acceptées: false, true

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant 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.