View a markdown version of this page

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 nos 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 de comandos e criar aplicativos que respondam às mudanças de status.

Tópicos do evento de execução de comandos

Os eventos de execução de comandos 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 de todos os comandos e status, assine o tópico a seguir usando caracteres curinga:

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

Quando o status de execução de um comando muda, AWS IoT publica uma mensagem de evento no tópico MQTT correspondente. 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”.

Comandante: ARN

O nome de recurso da Amazon (ARN) do comando.

Alvo ARN

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.