az iot hub message-route

  • Préversion
  • Référence

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 iot hub message-route . En savoir plus 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

Gérer les itinéraires d’un IoT Hub.

Commandes

Nom Description Type Statut
az iot hub message-route create

Ajoutez un itinéraire pour un IoT Hub.

 Extension Aperçu
az iot hub message-route delete

Supprimez tous les itinéraires ou un itinéraire mentionné dans un Hub IoT.

 Extension Aperçu
az iot hub message-route fallback

Gérez l’itinéraire de secours d’un hub IoT.

 Extension Aperçu
az iot hub message-route fallback set

Activez ou désactivez l’itinéraire de secours dans un Hub IoT.

 Extension Aperçu
az iot hub message-route fallback show

Affichez l’itinéraire de secours d’un IoT Hub.

 Extension Aperçu
az iot hub message-route list

Obtenez tous les itinéraires dans un Hub IoT.

 Extension Aperçu
az iot hub message-route show

Obtenez des informations sur l’itinéraire dans un Hub IoT.

 Extension Aperçu
az iot hub message-route test

Testez tous les itinéraires ou un itinéraire mentionné dans un Hub IoT.

 Extension Aperçu
az iot hub message-route update

Mettez à jour un itinéraire pour un hub IoT.

 Extension Aperçu

az iot hub message-route create

Préversion

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

Ajoutez un itinéraire pour un IoT Hub.

az iot hub message-route create --en
                                --hub-name
                                --rn
                                --source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}
                                [--condition]
                                [--enabled {false, true}]
                                [--resource-group]

Exemples

Créez un itinéraire pour un Hub IoT avec le point de terminaison et le type de source donnés « DeviceMessages ».

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

Créez un itinéraire pour un Hub IoT avec le point de terminaison intégré et le type de source « DeviceMessages ».

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name events --source DeviceMessages

Créez un itinéraire désactivé pour un Hub IoT avec le point de terminaison donné, le type de source « DigitalTwinChangeEvents » et la condition personnalisée.

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DigitalTwinChangeEvents --condition {condition} --enabled false

Paramètres obligatoires

--en --endpoint --endpoint-name

Nom du point de terminaison de routage. Pour le point de terminaison intégré, utilisez le nom de point de terminaison « événements ».

--hub-name -n

Nom d’IoT Hub.

--rn --route --route-name

Nom de la route.

--source-type --type -t

Source de l’itinéraire.

valeurs acceptées: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents

Paramètres facultatifs

--condition -c

Condition évaluée pour appliquer la règle de routage.

valeur par défaut: true
--enabled -e

Valeur booléenne indiquant s’il faut activer l’itinéraire vers le hub IoT.

valeurs acceptées: false, true
valeur par défaut: True
--resource-group -g

Nom du groupe de ressources. 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 iot hub message-route delete

Préversion

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

Supprimez tous les itinéraires ou un itinéraire mentionné dans un Hub IoT.

az iot hub message-route delete --hub-name
                                [--resource-group]
                                [--rn]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                                [--yes {false, true}]

Exemples

Supprimez un itinéraire d’un hub IoT.

az iot hub message-route delete -n {iothub_name} --route-name {route_name}

Supprimez tous les itinéraires de type source « DeviceMessages » d’un Hub IoT.

az iot hub message-route delete -n {iothub_name} --source DeviceMessages

Supprimez tous les itinéraires d’un Hub IoT.

az iot hub message-route delete -n {iothub_name}

Paramètres obligatoires

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rn --route --route-name

Nom de la route.

--source-type --type -t

Source de l’itinéraire.

valeurs acceptées: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--yes -y

Ignorez les invites de l’utilisateur. Indique l’acceptation de l’action. Utilisé principalement pour les scénarios d’automatisation. Valeur par défaut : false.

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 hub message-route list

Préversion

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

Obtenez tous les itinéraires dans un Hub IoT.

az iot hub message-route list --hub-name
                              [--resource-group]
                              [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]

Exemples

Obtenez tous les itinéraires à partir d’un Hub IoT.

az iot hub message-route list -n {iothub_name}

Obtenez tous les itinéraires de type source « DeviceMessages » à partir d’un Hub IoT.

az iot hub message-route list -n {iothub_name} --source DeviceMessages

Paramètres obligatoires

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--source-type --type -t

Source de l’itinéraire.

valeurs acceptées: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
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 hub message-route show

Préversion

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

Obtenez des informations sur l’itinéraire dans un Hub IoT.

az iot hub message-route show --hub-name
                              --rn
                              [--resource-group]

Exemples

Obtenez des informations de routage à partir d’un Hub IoT.

az iot hub message-route show -n {iothub_name} --route-name {route_name}

Paramètres obligatoires

--hub-name -n

Nom d’IoT Hub.

--rn --route --route-name

Nom de la route.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. 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 iot hub message-route test

Préversion

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

Testez tous les itinéraires ou un itinéraire mentionné dans un Hub IoT.

Vous pouvez fournir un exemple de message pour tester vos itinéraires.

az iot hub message-route test --hub-name
                              [--ap]
                              [--body]
                              [--resource-group]
                              [--rn]
                              [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                              [--sp]

Exemples

Testez une route à partir d’un hub IoT.

az iot hub message-route test -n {iothub_name} --route-name {route_name}

Testez tous les itinéraires de type source « DeviceMessages » à partir d’un Hub IoT.

az iot hub message-route test -n {iothub_name} --source DeviceMessages

Testez tous les itinéraires à partir d’un Hub IoT avec un message personnalisé, notamment le corps, les propriétés de l’application et les propriétés système.

az iot hub message-route test -n {iothub_name} -b {body} --ap {app_properties} --sp {system_properties}

Paramètres obligatoires

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--ap --app-properties

Propriétés de l’application du message de routage.

--body -b

Corps du message de routage.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rn --route --route-name

Nom de la route.

--source-type --type -t

Source de l’itinéraire.

valeurs acceptées: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--sp --system-properties

Propriétés système du message de routage.

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 hub message-route update

Préversion

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

Mettez à jour un itinéraire pour un hub IoT.

Vous pouvez modifier l’état source, point de terminaison, condition ou activé sur l’itinéraire.

az iot hub message-route update --hub-name
                                --rn
                                [--condition]
                                [--en]
                                [--enabled {false, true}]
                                [--resource-group]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]

Exemples

Mettez à jour un itinéraire vers un point de terminaison donné et un type de source « DeviceMessages ».

az iot hub message-route update -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

Désactivez un itinéraire.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --enabled false

Modifiez la condition d’un itinéraire.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --condition {condition}

Paramètres obligatoires

--hub-name -n

Nom d’IoT Hub.

--rn --route --route-name

Nom de la route.

Paramètres facultatifs

--condition -c

Condition évaluée pour appliquer la règle de routage.

--en --endpoint --endpoint-name

Nom du point de terminaison de routage. Pour le point de terminaison intégré, utilisez le nom de point de terminaison « événements ».

--enabled -e

Valeur booléenne indiquant s’il faut activer l’itinéraire vers le hub IoT.

valeurs acceptées: false, true
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--source-type --type -t

Source de l’itinéraire.

valeurs acceptées: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
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.