Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Peristiwa eksekusi perintah
<a name="command-events"></a>

AWS IoT menerbitkan pesan acara ke topik MQTT saat eksekusi perintah mengubah status. Anda dapat menggunakan peristiwa ini untuk memantau kemajuan eksekusi perintah dan membangun aplikasi yang merespons perubahan status.

**Topik acara eksekusi perintah**  
Peristiwa eksekusi perintah dipublikasikan ke topik MQTT berikut:

```
$aws/events/commandExecution/commandId/status
```

Di mana:
+ `commandId`adalah pengenal perintah.
+ `status`adalah status eksekusi perintah. Nilai yang valid adalah:`CREATED`,`IN_PROGRESS`,`SUCCEEDED`,`FAILED`,`REJECTED`,`TIMED_OUT`.

Untuk menerima pemberitahuan untuk semua perintah dan semua status, berlangganan topik berikut menggunakan karakter wildcard:

```
$aws/events/commandExecution/+/#
```

**Pesan acara eksekusi perintah**  
Ketika status eksekusi perintah berubah, AWS IoT menerbitkan pesan peristiwa ke topik MQTT yang sesuai. Pesan berisi contoh payload berikut:

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

Payload berisi atribut berikut:

**ExecutionID**  
Sebuah identifier unik untuk eksekusi perintah (string).

**status**  
Status eksekusi perintah. Nilai yang valid adalah:`CREATED`,`IN_PROGRESS`,`SUCCEEDED`,`FAILED`,`REJECTED`,`TIMED_OUT`.

**StatusReason**  
Objek yang berisi informasi tambahan tentang status, jika tersedia. Berisi `reasonCode` dan `reasonDescription` bidang.

**EventType**  
Setel ke “COMMAND\$1EXECUTION”.

**Commandarn**  
Nama Sumber Daya Amazon (ARN) dari perintah.

**TargetArn**  
ARN perangkat target (benda atau klien) untuk eksekusi perintah.

**stempel waktu**  
Stempel waktu UNIX saat peristiwa terjadi.