View a markdown version of this page

É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 les rubriques MQTT lorsque les exécutions de commandes changent de statut. Vous pouvez utiliser ces événements pour suivre 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 l'état 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 d'exécution de commande

Lorsque l'état 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 l'état, le cas échéant. Contient reasonCode et reasonDescription champs.

eventType

Réglez sur « COMMAND_EXECUTION ».

Commande Arn

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

Tarn cible

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

timestamp

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