Événements d'exécution de commandes - AWS IoT Core

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Événements d'exécution de commandes

AWS IoT publie des messages d'événements dans des rubriques MQTT lorsque l'état des exécutions de commandes change. Vous pouvez utiliser ces événements pour surveiller la progression de l'exécution des commandes et créer des applications qui répondent aux changements de statut.

Rubriques relatives aux événements d'exécution de commandes

Les événements d'exécution de commandes sont publiés dans la rubrique MQTT suivante :

$aws/events/commandExecution/commandId/status

Où :

  • commandIdest l'identifiant de la commande.

  • statusest le statut de l'exécution de la commande. Les valeurs valides sont: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

Pour recevoir des notifications pour toutes les commandes et tous les statuts, abonnez-vous à la rubrique suivante en utilisant des caractères génériques :

$aws/events/commandExecution/+/#
Message d'événement relatif à l'exécution des commandes

Lorsque le statut d'exécution d'une commande change, AWS IoT publie un message d'événement dans la rubrique MQTT correspondante. Le message contient l'exemple de charge utile suivant :

{
    "executionId": "2bd65c51-4cfd-49e4-9310-d5cbfdbc8554",
    "status": "FAILED",
    "statusReason": {
        "reasonCode": "DEVICE_TOO_BUSY",
        "reasonDescription": ""
    },
    "eventType": "COMMAND_EXECUTION",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/0b9d9ddf-e873-43a9-8e2c-9fe004a90086",
    "targetArn": "arn:aws:iot:us-east-1:123456789012:thing/5006c3fc-de96-4def-8427-7eee36c6f2bd",
    "timestamp": 1717708862107
}

Les charges utiles contiennent les attributs suivants :

ID d'exécution

Identifiant unique pour l'exécution de la commande (chaîne).

status

État de l'exécution de la commande. Les valeurs valides sont: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

Motif du statut

Un objet contenant des informations supplémentaires sur le statut, si elles sont disponibles. Contient reasonCode et reasonDescription champs.

eventType

Réglé sur « COMMAND_EXECUTION ».

Commander RN

Le nom de ressource Amazon (ARN) de la commande.

TargetArn

L'ARN de l'équipement cible (objet ou client) pour l'exécution de la commande.

timestamp

L'horodatage UNIX du moment où l'événement s'est produit.