Concepts et statut des commandes

Les commandes sont des instructions envoyées depuis le cloud à vos appareils IoT. Ces instructions (charge utile de commande) sont envoyées aux appareils sous forme de MQTT messages. Une fois que les appareils ont reçu la charge utile de la commande, ils peuvent traiter les instructions pour effectuer l'action correspondante. Ces actions incluent par exemple la modification des paramètres de configuration de l'appareil, la transmission des relevés des capteurs ou le téléchargement de journaux. Les appareils peuvent ensuite exécuter la commande et renvoyer le résultat dans le cloud. Cela vous permet de surveiller et de contrôler à distance les appareils connectés.

Lorsque vous utilisez la fonctionnalité des commandes, vous pouvez spécifier l'espace de noms de la commande. Lorsque vous souhaitez créer une commande dans AWS IoT Device Management, vous devez utiliser l'espace de AWS-IoT noms par défaut. Lorsque vous utilisez cet espace de noms, vous devez fournir une charge utile lors de la création de la commande. La charge utile sera utilisée lorsque vous exécuterez la commande sur votre appareil cible. Si vous souhaitez créer une commande pour à la AWS IoT FleetWise place, vous devez utiliser l'espace de AWS-IoT-FleetWise noms à la place. Pour plus d'informations, consultez la section Commandes distantes dans le guide du AWS IoT FleetWise développeur consacré aux commandes.

Lorsque vous créez la commande, vous devez fournir une charge utile qui définit les actions que le terminal doit effectuer. La charge utile peut utiliser n'importe quel format de votre choix. Pour vous assurer que l'appareil peut lire et comprendre correctement les informations que vous envoyez, nous vous recommandons de spécifier le type de format de charge utile dans la commande. Si vos appareils l'utilisentMQTT5, ils peuvent suivre la MQTT norme pour identifier le format de charge utile. Un indicateur de format pour JSON ou CBOR sera disponible dans la rubrique de demande de commandes.

Lorsque vous souhaitez exécuter la commande, vous devez spécifier une machine cible qui recevra la commande et exécutera les actions. Si votre appareil a été enregistré en tant qu'objet auprès de l'objet AWS IoT, vous pouvez utiliser le nom de l'objet. Si votre appareil n'a pas été enregistré, vous pouvez utiliser l'identifiant MQTT client à la place. L'ID client est un identifiant unique pour votre appareil ou client défini dans le MQTT protocole. Il peut être utilisé pour connecter votre appareil à AWS IoT.

Une exécution de commande est une instance d'une commande exécutée sur le périphérique cible. Lorsque vous lancez l'exécution, la commande (charge utile) est envoyée à l'équipement cible. Un identifiant d'exécution de commande unique est désormais généré pour la cible. L'appareil peut ensuite exécuter la commande et rendre compte de sa progression à AWS IoT. La logique côté appareil détermine la manière dont la commande sera exécutée et la manière dont le statut sera publié dans les rubriques réservées.

Avant d'exécuter la commande, votre appareil doit être abonné à la rubrique de demande de commandes. Lorsque vous envoyez la demande au cloud pour exécuter la commande, la charge utile est envoyée à l'appareil dans la rubrique de demande de commande. Une fois que le périphérique a exécuté la commande, il peut publier le résultat et l'état de l'exécution dans la rubrique de réponse aux commandes. Pour de plus amples informations, veuillez consulter Rubriques relatives aux commandes.

Une fois que vous avez créé avec succès une ressource de commande, elle sera disponible. La commande peut désormais être utilisée pour envoyer une exécution de commande à l'appareil.

Si vous n'avez plus l'intention d'utiliser une commande, vous pouvez la marquer comme obsolète. Dans cet état, vous ne pouvez pas envoyer de nouvelles exécutions de la commande sur vos appareils. Toutes les exécutions en attente qui ont déjà commencé continueront de s'exécuter sur l'appareil jusqu'à la fin. Pour envoyer de nouvelles exécutions, vous devez restaurer la commande afin qu'elle soit disponible.

Lorsque vous marquez une commande pour suppression, si la commande est devenue obsolète pendant une durée supérieure au délai maximum, elle est automatiquement supprimée. Cette action est permanente et ne peut pas être annulée. Par défaut, la durée maximale du délai d'attente est de 12 heures. Si la commande n'est pas obsolète, ou si elle l'a été pendant une durée inférieure au délai maximum, elle sera en attente de suppression. La commande sera automatiquement supprimée de votre compte après la durée maximale du délai d'expiration.