Eventi di esecuzione dei comandi - AWS IoT Core

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Eventi di esecuzione dei comandi

AWS IoT pubblica messaggi di eventi su argomenti MQTT quando l'esecuzione dei comandi cambia lo stato. È possibile utilizzare questi eventi per monitorare l'avanzamento dell'esecuzione dei comandi e creare applicazioni che rispondono ai cambiamenti di stato.

Argomenti degli eventi di esecuzione dei comandi

Gli eventi di esecuzione dei comandi sono pubblicati nel seguente argomento MQTT:

$aws/events/commandExecution/commandId/status

Dove:

  • commandIdè l'identificatore del comando.

  • statusè lo stato dell'esecuzione del comando. I valori validi sono: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

Per ricevere notifiche per tutti i comandi e tutti gli stati, sottoscrivi il seguente argomento utilizzando caratteri jolly:

$aws/events/commandExecution/+/#
Messaggio relativo all'evento di esecuzione del comando

Quando lo stato di esecuzione di un comando cambia, AWS IoT pubblica un messaggio di evento nell'argomento MQTT corrispondente. Il messaggio contiene il seguente payload di esempio:

{
    "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
}

Il payload contiene gli attributi seguenti:

ID di esecuzione

Un identificatore univoco per l'esecuzione del comando (stringa).

status

Lo stato dell'esecuzione del comando. I valori validi sono: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

StatusReason

Un oggetto contenente informazioni aggiuntive sullo stato, se disponibili. Contiene reasonCode e reasonDescription campi.

eventType

Impostato su «COMMAND_EXECUTION».

COMANDOARN

L'Amazon Resource Name (ARN) del comando.

TargetARN

L'ARN del dispositivo di destinazione (cosa o client) per l'esecuzione del comando.

timestamp

Timestamp UNIX del momento in cui si è verificato l'evento.