Partager via

az dt route

Note

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

Gérer et configurer des itinéraires d’événements.

Notez qu’un point de terminaison doit d’abord être configuré avant d’ajouter un itinéraire d’événement.

Commandes

Nom Description Type État
az dt route create

Ajoutez un itinéraire d’événement à une instance Digital Twins.

 Extension GA
az dt route delete

Supprimez un itinéraire d’événement d’une instance Digital Twins.

 Extension GA
az dt route list

Répertoriez les itinéraires d’événements configurés d’une instance Digital Twins.

 Extension GA
az dt route show

Afficher les détails d’un itinéraire d’événement configuré sur une instance Digital Twins.

 Extension GA

az dt route create

Ajoutez un itinéraire d’événement à une instance Digital Twins.

az dt route create --dt-name --dtn
                   --en --endpoint-name
                   --rn --route-name
                   [--filter]
                   [--resource-group]

Exemples

Ajoute une route d’événement pour un point de terminaison existant sur l’instance cible avec le filtre par défaut « true ».

az dt route create -n {instance_or_hostname} --endpoint-name {endpoint_name} --route-name {route_name}

Ajoute une route d’événement pour un point de terminaison existant sur l’instance cible avec un filtre personnalisé.

az dt route create -n {instance_or_hostname} --endpoint-name {endpoint_name} --route-name {route_name} --filter "type = 'Microsoft.DigitalTwins.Twin.Create'"

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.

--en --endpoint-name

Nom du point de terminaison.

--rn --route-name

Nom de l’itinéraire d’événement.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--filter

Filtre d’itinéraire d’événement.

Propriété Valeur
Valeur par défaut: true
--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az dt route delete

Supprimez un itinéraire d’événement d’une instance Digital Twins.

az dt route delete --dt-name --dtn
                   --rn --route-name
                   [--resource-group]

Exemples

Supprimez un itinéraire d’événement d’une instance cible.

az dt route delete -n {instance_or_hostname} --route-name {route_name}

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.

--rn --route-name

Nom de l’itinéraire d’événement.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az dt route list

Répertoriez les itinéraires d’événements configurés d’une instance Digital Twins.

az dt route list --dt-name --dtn
                 [--resource-group]

Exemples

Répertorier les itinéraires d’événements configurés d’une instance cible.

az dt route list -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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az dt route show

Afficher les détails d’un itinéraire d’événement configuré sur une instance Digital Twins.

az dt route show --dt-name --dtn
                 --rn --route-name
                 [--resource-group]

Exemples

Afficher un itinéraire d’événement sur une instance cible.

az dt route show -n {instance_or_hostname} --route-name {route_name}

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.

--rn --route-name

Nom de l’itinéraire d’événement.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False