az iot device c2d-message
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 device c2d-message . En savoir plus sur les extensions.
Commandes de messagerie cloud à appareil.
Commandes
Nom | Description | Type | Statut |
---|---|---|---|
az iot device c2d-message abandon |
Abandonner un message cloud-à-appareil. |
Extension | GA |
az iot device c2d-message complete |
Terminez un message cloud-à-appareil. |
Extension | GA |
az iot device c2d-message purge |
Videz la file d’attente de messages cloud-à-appareil pour un appareil cible. |
Extension | GA |
az iot device c2d-message receive |
Recevoir un message cloud-à-appareil. |
Extension | GA |
az iot device c2d-message reject |
Rejeter ou deadletter un message cloud-à-appareil. |
Extension | GA |
az iot device c2d-message send |
Envoyez un message cloud-à-appareil. |
Extension | GA |
az iot device c2d-message abandon
Abandonner un message cloud-à-appareil.
az iot device c2d-message abandon --device-id
[--etag]
[--hub-name]
[--login]
[--resource-group]
Paramètres obligatoires
ID d’appareil cible.
Paramètres facultatifs
Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.
Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.
Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --hub-name n’est pas fourni.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot device c2d-message complete
Terminez un message cloud-à-appareil.
az iot device c2d-message complete --device-id
[--etag]
[--hub-name]
[--login]
[--resource-group]
Paramètres obligatoires
ID d’appareil cible.
Paramètres facultatifs
Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.
Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.
Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --hub-name n’est pas fourni.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot device c2d-message purge
Videz la file d’attente de messages cloud-à-appareil pour un appareil cible.
az iot device c2d-message purge --device-id
[--hub-name]
[--login]
[--resource-group]
Paramètres obligatoires
ID d’appareil cible.
Paramètres facultatifs
Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.
Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --hub-name n’est pas fourni.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot device c2d-message receive
Recevoir un message cloud-à-appareil.
Le corps du message reçu est décodé uniquement lorsque son encodage de contenu est défini sur « utf-8 », « utf-16 » ou « utf-32 ». La charge utile du message s’affiche en tant que {{charge utile non décodable}} lorsque l’encodage du contenu n’est pas défini sur l’un des éléments ci-dessus ou ne parvient pas à décoder même lorsque l’encodage du contenu est défini sur l’un des éléments ci-dessus.
Remarque : un seul argument de message [--complete, --reject, --abandon] est accepté.
az iot device c2d-message receive --device-id
[--abandon {false, true}]
[--complete {false, true}]
[--hub-name]
[--lock-timeout]
[--login]
[--reject {false, true}]
[--resource-group]
Exemples
Utilisation de base
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group}
Recevoir un message et définir un délai d’expiration de verrouillage de 30 secondes pour ce message
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --lt {30}
Recevoir un message et l’envoyer comme « terminé » une fois qu’il a été reçu
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --complete
Recevoir un message et le rejeter une fois qu’il a été reçu
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --reject
Paramètres obligatoires
ID d’appareil cible.
Paramètres facultatifs
Abandonnez le message cloud-à-appareil après réception.
Terminez le message cloud-à-appareil après réception.
Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.
Spécifie la durée pendant laquelle un message sera invisible pour d’autres appels de réception.
Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --hub-name n’est pas fourni.
Rejeter le message cloud-à-appareil après réception.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot device c2d-message reject
Rejeter ou deadletter un message cloud-à-appareil.
az iot device c2d-message reject --device-id
[--etag]
[--hub-name]
[--login]
[--resource-group]
Paramètres obligatoires
ID d’appareil cible.
Paramètres facultatifs
Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.
Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.
Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --hub-name n’est pas fourni.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az iot device c2d-message send
Envoyez un message cloud-à-appareil.
Cette commande s’appuie et peut installer le package Cython dépendant (uamqp) lors de la première exécution. https://github.com/Azure/azure-uamqp-python
Remarque : l’encodage du contenu est défini par défaut sur utf-8. La commande envoie le corps du message avec une action d’encodage lorsque la propriété d’encodage de contenu est utf-8, utf-16 ou utf-32. Si la valeur d’encodage de contenu n’est pas l’une de ces valeurs, la propriété est toujours envoyée sans aucune action d’encodage effectuée.
Lors de l’envoi d’un corps de message binaire, le contenu doit être fourni à partir d’un fichier (via --data-file-path
) et le type de contenu doit être défini sur application/octet-stream
.
az iot device c2d-message send --device-id
[--ack {full, negative, positive}]
[--auth-type {key, login}]
[--ce]
[--cid]
[--content-type]
[--da]
[--data-file-path]
[--expiry]
[--hub-name]
[--login]
[--message-id]
[--properties]
[--repair {false, true}]
[--resource-group]
[--uid]
[--wait {false, true}]
[--yes {false, true}]
Exemples
Utilisation de base avec le corps du message par défaut
az iot device c2d-message send -d {device_id} -n {iothub_name}
Envoyez un message cloud-à-appareil avec des données et des propriétés personnalisées.
az iot device c2d-message send -d {device_id} -n {iothub_name} --data 'Hello World' --props 'key0=value0;key1=value1'
Envoyer un message C2D et attendre l’accusé de réception de l’appareil
az iot device c2d-message send -d {device_id} -n {iothub_name} --ack full --wait
Envoyez un message C2D au format binaire à partir d’un fichier.
az iot device c2d-message send -d {device_id} -n {iothub_name} --data-file-path {file_path} --content-type 'application/octet-stream'
Envoyez un message C2D au format JSON à partir d’un fichier.
az iot device c2d-message send -d {device_id} -n {iothub_name} --data-file-path {file_path} --content-type 'application/json'
Paramètres obligatoires
ID d’appareil cible.
Paramètres facultatifs
Demandez la remise de commentaires par message concernant l’état final de ce message. La description des valeurs ack est la suivante. Positif : si le message c2d atteint l’état Terminé, IoT Hub génère un message de commentaires. Négatif : si le message c2d atteint l’état de lettres mortes, IoT Hub génère un message de commentaires. Complet : IoT Hub génère un message de commentaires dans les deux cas. Par défaut, aucun ack n’est demandé.
Indique si l’opération doit dériver automatiquement une clé de stratégie ou utiliser la session Azure AD actuelle. Si le type d’authentification est login et que le nom d’hôte de ressource est fourni, la recherche de ressources est ignorée, sauf si nécessaire. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults iothub-data-auth-type=<auth-type-value>
de .
Encodage du corps du message C2D.
ID de corrélation associé au message C2D.
Type de contenu pour le corps du message C2D.
Corps du message. Fournissez du texte ou du json brut.
Indiquez le chemin d’accès au fichier pour la charge utile du corps du message. Notez que la charge utile doit être envoyée au format binaire, définissez le type de contenu sur application/octet-stream.
Les unités sont des millisecondes depuis l’époque unix. Si aucune heure n’est indiquée, la durée de vie du message C2D IoT Hub par défaut est utilisée.
Nom ou nom d’hôte IoT Hub. Obligatoire si --login n’est pas fourni.
Cette commande prend en charge une entité chaîne de connexion avec des droits d’exécution d’action. Permet d’éviter la connexion de session via « az login ». Si une entité chaîne de connexion et un nom sont fournis, le chaîne de connexion a la priorité. Obligatoire si --hub-name n’est pas fourni.
ID du message C2D. Si aucun ID de message n’est fourni, un UUID est généré.
Conteneur de propriétés de message dans des paires clé-valeur au format suivant : a=b ; c=d.
Réinstallez la dépendance uamqp compatible avec la version de l’extension. Valeur par défaut : false.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Message C2D, propriété ID utilisateur.
Si l’opération d’envoi c2d se bloque jusqu’à ce que les commentaires de l’appareil aient été reçus.
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.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour