Eventos de execução de comandos - AWS IoT Core

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Eventos de execução de comandos

AWS IoT publica mensagens de eventos em tópicos do MQTT quando as execuções de comandos mudam de status. Você pode usar esses eventos para monitorar o progresso da execução do comando e criar aplicativos que respondam às mudanças de status.

Tópicos de eventos de execução de comandos

Os eventos de execução do comando são publicados no seguinte tópico do MQTT:

$aws/events/commandExecution/commandId/status

Em que:

  • commandIdé o identificador do comando.

  • statusé o status da execução do comando. Os valores válidos são: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

Para receber notificações para todos os comandos e todos os status, assine o tópico a seguir usando caracteres curinga:

$aws/events/commandExecution/+/#
Mensagem do evento de execução do comando

Quando o status de execução de um comando muda, AWS IoT publica uma mensagem de evento no tópico correspondente do MQTT. A mensagem contém as seguintes cargas úteis de exemplo:

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

As cargas contêm os seguintes atributos:

ID de execução

Um identificador exclusivo para a execução do comando (string).

status

O status da execução do comando. Os valores válidos são: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT.

statusReason

Um objeto contendo informações adicionais sobre o status, se disponível. Contém reasonCode e reasonDescription campos.

eventType

Defina como “COMMAND_EXECUTION”.

Comando ARN

O Amazon Resource Name (ARN) do comando.

TargetARN

O ARN do dispositivo de destino (coisa ou cliente) para a execução do comando.

timestamp

A data e hora do UNIX de quando o evento ocorreu.