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
<a name="command-events"></a>

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\$1EXECUTION”.

**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.