Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Topik MQTT
Topik MQTT mengidentifikasi pesan. AWS IoT AWS IoT klien mengidentifikasi pesan yang mereka terbitkan dengan memberikan nama topik pesan. Klien mengidentifikasi pesan yang ingin mereka berlangganan (terima) dengan mendaftarkan filter topik AWS IoT Core. Broker pesan menggunakan nama topik dan filter topik untuk merutekan pesan dari klien penerbitan ke klien berlangganan.
Broker pesan menggunakan topik untuk mengidentifikasi pesan yang dikirim menggunakan MQTT dan dikirim menggunakan HTTP ke. [URL pesan HTTPS](http.md#httpurl)
Sementara AWS IoT mendukung beberapa [topik sistem cadangan](reserved-topics.md), sebagian besar topik MQTT dibuat dan dikelola oleh Anda, perancang sistem. AWS IoT menggunakan topik untuk mengidentifikasi pesan yang diterima dari klien penerbitan dan memilih pesan untuk dikirim ke klien berlangganan, seperti yang dijelaskan di bagian berikut. Sebelum Anda membuat namespace topik untuk sistem Anda, tinjau karakteristik topik MQTT untuk membuat hierarki nama topik yang paling sesuai untuk sistem IoT Anda.
## Nama topik
Nama topik dan filter topik adalah string yang dikodekan UTF-8. Mereka dapat mewakili hierarki informasi dengan menggunakan karakter garis miring maju (/) untuk memisahkan tingkat hierarki. Misalnya, nama topik ini bisa merujuk ke sensor suhu di ruangan 1:
+ `sensor/temperature/room1`
Dalam contoh ini, mungkin juga ada jenis sensor lain di ruangan lain dengan nama topik seperti:
+ `sensor/temperature/room2`
+ `sensor/humidity/room1`
+ `sensor/humidity/room2`
**catatan**
Saat Anda mempertimbangkan nama topik untuk pesan di sistem Anda, ingatlah:
Nama topik dan filter topik peka huruf besar/kecil.
Nama topik tidak boleh berisi informasi yang dapat diidentifikasi secara pribadi.
Nama topik yang dimulai dengan \$1 adalah [topik yang dicadangkan](reserved-topics.md) untuk digunakan hanya oleh AWS IoT Core.
AWS IoT Core tidak dapat mengirim atau menerima pesan antara Akun AWS s atau Wilayah.
Untuk informasi selengkapnya tentang mendesain nama topik dan namespace Anda, lihat whitepaper kami, [Merancang](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html) Topik MQTT untuk. AWS IoT Core
Untuk contoh bagaimana aplikasi dapat mempublikasikan dan berlangganan pesan, mulailah dengan [Memulai dengan AWS IoT Core tutorial](iot-gs.md) dan[AWS IoT Klien Perangkat SDKs SDKs, Seluler, dan AWS IoT Perangkat](iot-sdks.md).
**penting**
Namespace topik terbatas pada Akun AWS dan Wilayah. Misalnya, `sensor/temp/room1` topik yang digunakan oleh Akun AWS dalam satu Wilayah berbeda dari `sensor/temp/room1` topik yang digunakan oleh AWS akun yang sama di Wilayah lain atau digunakan oleh orang lain Akun AWS di Wilayah mana pun.
## Topik ARN
Semua topik ARNs (Nama Sumber Daya Amazon) memiliki formulir berikut:
```
arn:aws:iot:aws-region:AWS-account-ID:topic/Topic
```
Misalnya, `arn:aws:iot:us-west-2:123EXAMPLE456:topic/application/topic/device/sensor` adalah ARN untuk topik tersebut. ` application/topic/device/sensor`
## Filter nama topik
Klien berlangganan mendaftarkan filter nama topik dengan broker pesan untuk menentukan topik pesan yang harus dikirim oleh broker pesan kepada mereka. Filter nama topik dapat berupa nama topik tunggal untuk berlangganan satu nama topik atau dapat menyertakan karakter wildcard untuk berlangganan beberapa nama topik secara bersamaan.
Klien penerbitan tidak dapat menggunakan karakter wildcard dalam nama topik yang mereka terbitkan.
Tabel berikut mencantumkan karakter wildcard yang dapat digunakan dalam filter topik.
**Wildcard topik**
| Karakter wildcard | Cocok | Catatan |
| --- | --- | --- |
| \$1 | Semua string di dan di bawah levelnya dalam hierarki topik. | Harus menjadi karakter terakhir dalam filter topik. Harus menjadi satu-satunya karakter dalam tingkat hierarki topiknya. Dapat digunakan dalam filter topik yang juga berisi karakter wildcard \$1. |
| \$1 | String apa pun di level yang berisi karakter. | Harus menjadi satu-satunya karakter dalam tingkat hierarki topiknya. Dapat digunakan di berbagai tingkatan filter topik. |
Menggunakan wildcard dengan contoh nama topik sensor sebelumnya:
+ Langganan untuk `sensor/#` menerima pesan yang dipublikasikan ke`sensor/`, `sensor/temperature``sensor/temperature/room1`, tetapi bukan pesan yang dipublikasikan ke`sensor`.
+ Langganan untuk `sensor/+/room1` menerima pesan yang dipublikasikan ke `sensor/temperature/room1` dan`sensor/humidity/room1`, tetapi bukan pesan yang dikirim ke `sensor/temperature/room2` atau`sensor/humidity/room2`.
### Filter topik ARN
Semua filter topik ARNs (Nama Sumber Daya Amazon) memiliki formulir berikut:
```
arn:aws:iot:aws-region:AWS-account-ID:topicfilter/TopicFilter
```
Misalnya, `arn:aws:iot:us-west-2:123EXAMPLE456:topicfilter/application/topic/+/sensor` adalah ARN untuk filter topik. ` application/topic/+/sensor`
# Muatan pesan MQTT
Payload pesan yang dikirim dalam pesan MQTT Anda tidak ditentukan oleh AWS IoT, kecuali untuk salah satu pesan. [Topik cadangan](reserved-topics.md) [Untuk mengakomodasi kebutuhan aplikasi Anda, kami sarankan Anda menentukan payload pesan untuk topik Anda dalam batasan Service Quotas AWS IoT Core for Protocols.](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-protocol-limits)
Menggunakan format JSON untuk payload pesan Anda memungkinkan mesin AWS IoT aturan untuk mengurai pesan Anda dan menerapkan kueri SQL ke dalamnya. Jika aplikasi Anda tidak memerlukan mesin aturan untuk menerapkan kueri SQL ke muatan pesan, Anda dapat menggunakan format data apa pun yang diperlukan aplikasi Anda. Untuk informasi tentang batasan dan karakter yang dicadangkan dalam dokumen JSON yang digunakan dalam kueri SQL, lihat. [Ekstensi JSON](iot-sql-json.md)
Untuk informasi selengkapnya tentang mendesain topik MQTT Anda dan muatan pesan yang sesuai, lihat [Merancang](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html) Topik MQTT untuk. AWS IoT Core
Jika batas ukuran pesan melebihi kuota layanan, itu akan menghasilkan alasan `CLIENT_ERROR` dengan `PAYLOAD_LIMIT_EXCEEDED` dan “Payload pesan melebihi batas ukuran untuk jenis pesan.” Untuk informasi selengkapnya tentang batas ukuran [AWS IoT Core pesan, lihat batas dan kuota broker pesan](https://docs.aws.amazon.com//general/latest/gr/iot-core.html#message-broker-limits.html).
# Topik cadangan
Topik yang dimulai dengan tanda dolar (\$1) dicadangkan untuk digunakan oleh AWS IoT. Anda dapat berlangganan dan mempublikasikan topik yang dipesan ini jika memungkinkan; Namun, Anda tidak dapat membuat topik baru yang dimulai dengan tanda dolar. Operasi publikasi atau berlangganan yang tidak didukung ke topik yang dicadangkan dapat mengakibatkan koneksi terputus.
## Topik model aset
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1 aws/sitewise/asset -model/ /aset/ *assetModelId* /properties/ *assetId* *propertyId* | Langganan | AWS IoT SiteWise menerbitkan pemberitahuan properti aset untuk topik ini. Untuk informasi selengkapnya, lihat [Berinteraksi dengan AWS layanan lain](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html) di *Panduan AWS IoT SiteWise Pengguna*. |
## AWS IoT Device Defender topik
Pesan-pesan ini mendukung buffer respons dalam format Concise Binary Object Representation (CBOR) dan JavaScript Object Notation (JSON), tergantung pada topik. *payload-format* AWS IoT Device Defender topik hanya mendukung publikasi MQTT.
| *payload-format* | Jenis data format respons |
| --- | --- |
| cbor | Representasi Objek Biner Ringkas (CBOR) |
| json | JavaScript Notasi Objek (JSON) |
Untuk informasi selengkapnya, lihat [Mengirim metrik dari perangkat](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages).
| Topik | Operasi yang diizinkan | Deskripsi |
| --- | --- | --- |
| \$1 aws/hal//pembela/metrik/*thingName**payload-format* | Publikasikan | AWS IoT Device Defender agen mempublikasikan metrik untuk topik ini. Untuk informasi selengkapnya, lihat [Mengirim metrik dari perangkat](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1 aws/things//defender/metrik//diterima *thingName* *payload-format* | Langganan | AWS IoT menerbitkan ke topik ini setelah AWS IoT Device Defender agen menerbitkan pesan yang berhasil ke *thingName* \$1aws/things/ /defender/metrics/. *payload-format* Untuk informasi selengkapnya, lihat [Mengirim metrik dari perangkat](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1aws/things//defender/metrik//ditolak *thingName* *payload-format* | Langganan | AWS IoT menerbitkan ke topik ini setelah AWS IoT Device Defender agen menerbitkan pesan yang gagal ke \$1aws/things/ /defender/metrics/. *thingName* *payload-format* Untuk informasi selengkapnya, lihat [Mengirim metrik dari perangkat](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
## AWS IoT Core Topik Lokasi Perangkat
AWS IoT Core Lokasi Perangkat dapat menyelesaikan data pengukuran dari perangkat Anda dan memberikan perkiraan lokasi perangkat IoT Anda. Data pengukuran dari perangkat dapat mencakup GNSS, Wi-Fi, seluler, dan alamat IP. AWS IoT Core Lokasi Perangkat kemudian memilih jenis pengukuran yang memberikan akurasi terbaik dan memecahkan informasi lokasi perangkat. Untuk informasi selengkapnya, lihat [AWS IoT Core Lokasi Perangkat](device-location.md) dan [Menyelesaikan lokasi perangkat menggunakan topik AWS IoT Core MQTT Lokasi Perangkat](device-location-reserved-topics.md).
| Topik | Operasi yang diizinkan | Deskripsi |
| --- | --- | --- |
| *customer\$1device\$1id*\$1aws/device\$1location/ /get\$1position\$1estimate | Publikasikan | Perangkat memublikasikan topik ini agar data pengukuran mentah yang dipindai diselesaikan oleh Lokasi AWS IoT Core Perangkat. |
| *customer\$1device\$1id*\$1aws/device\$1location/ /get\$1position\$1estimate/diterima | Langganan | AWS IoT Core Lokasi Perangkat memublikasikan topik ini setelah berhasil menyelesaikan lokasi perangkat. |
| *customer\$1device\$1id*\$1aws/device\$1location/ /get\$1position\$1estimate/ditolak | Langganan | AWS IoT Core Lokasi Perangkat memublikasikan topik ini ketika tidak dapat menyelesaikan lokasi perangkat dengan sukses karena kesalahan 4xx. |
## Topik peristiwa
Pesan acara dipublikasikan ketika peristiwa tertentu terjadi. Misalnya, peristiwa dihasilkan oleh registri ketika hal-hal ditambahkan, diperbarui, atau dihapus. Tabel menunjukkan berbagai AWS IoT acara dan topik yang dipesan.
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1aws/events/certificates/registered/*caCertificateId* | Langganan | AWS IoT menerbitkan pesan ini ketika AWS IoT secara otomatis mendaftarkan sertifikat dan ketika klien menyajikan sertifikat dengan status. `PENDING_ACTIVATION` Untuk informasi selengkapnya, lihat [Konfigurasikan koneksi pertama oleh klien untuk pendaftaran otomatis](auto-register-device-cert.md#configure-auto-reg-first-connect). |
| \$1aws/events/job/*jobID*/dibatalkan | Langganan | AWS IoT memublikasikan pesan ini saat pekerjaan dibatalkan. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/jobID/cancellation\$1in\$1progress | Langganan | AWS IoT memublikasikan pesan ini saat pembatalan pekerjaan sedang berlangsung. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/*jobID*/selesai | Langganan | AWS IoT mempublikasikan pesan ini ketika pekerjaan telah selesai. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/jobID/dihapus | Langganan | AWS IoT memublikasikan pesan ini saat pekerjaan dihapus. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/jobID/deletion\$1in\$1progress | Langganan | AWS IoT menerbitkan pesan ini saat penghapusan pekerjaan sedang berlangsung. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/dibatalkan | Langganan | AWS IoT memublikasikan pesan ini saat eksekusi pekerjaan dibatalkan. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/dihapus | Langganan | AWS IoT memublikasikan pesan ini saat eksekusi pekerjaan dihapus. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/gagal | Langganan | AWS IoT memublikasikan pesan ini ketika eksekusi pekerjaan gagal. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/ditolak | Langganan | AWS IoT menerbitkan pesan ini ketika eksekusi pekerjaan ditolak. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/dihapus | Langganan | AWS IoT memublikasikan pesan ini ketika eksekusi pekerjaan telah dihapus. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/berhasil | Langganan | AWS IoT menerbitkan pesan ini ketika eksekusi pekerjaan berhasil. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/timed\$1out | Langganan | AWS IoT memublikasikan pesan ini saat eksekusi pekerjaan habis. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/presence/connected/*clientId* | Langganan | AWS IoT menerbitkan ke topik ini ketika klien MQTT dengan ID klien yang ditentukan terhubung ke. AWS IoT Untuk informasi selengkapnya, lihat [Hubungkan/Putuskan acara](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/presence/disconnected/*clientId* | Langganan | AWS IoT menerbitkan ke topik ini ketika klien MQTT dengan ID klien yang ditentukan terputus. AWS IoT Untuk informasi selengkapnya, lihat [Hubungkan/Putuskan acara](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/subscriptions/subscribed/*clientId* | Langganan | AWS IoT menerbitkan topik ini ketika klien MQTT dengan ID klien yang ditentukan berlangganan topik MQTT. Untuk informasi selengkapnya, lihat [Acara Berlangganan/Berhenti Berlangganan](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1aws/events/subscriptions/unsubscribed/*clientId* | Langganan | AWS IoT menerbitkan topik ini ketika klien MQTT dengan ID klien yang ditentukan berhenti berlangganan topik MQTT. Untuk informasi selengkapnya, lihat [Acara Berlangganan/Berhenti Berlangganan](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1aws/events/thing/*thingName*/dibuat | Langganan | AWS IoT menerbitkan topik ini ketika *thingName* benda itu dibuat. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thing/*thingName*/diperbarui | Langganan | AWS IoT menerbitkan ke topik ini ketika *thingName* hal diperbarui. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thing/*thingName*/dihapus | Langganan | AWS IoT menerbitkan ke topik ini ketika *thingName* hal itu dihapus. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/dibuat | Langganan | AWS IoT menerbitkan ke topik ini ketika grup sesuatu *thingGroupName* dibuat. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/diperbarui | Langganan | AWS IoT menerbitkan ke topik ini ketika grup hal *thingGroupName* diperbarui. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/dihapus | Langganan | AWS IoT menerbitkan ke topik ini ketika grup sesuatu *thingGroupName* dihapus. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/dibuat | Langganan | AWS IoT menerbitkan ke topik ini saat tipe *thingTypeName* benda dibuat. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/diperbarui | Langganan | AWS IoT menerbitkan ke topik ini ketika jenis *thingTypeName* hal diperbarui. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/dihapus | Langganan | AWS IoT menerbitkan ke topik ini ketika jenis *thingTypeName* hal dihapus. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingTypeAssociation/thing/*thingName*/*thingTypeName* | Langganan | AWS IoT menerbitkan ke topik ini ketika sesuatu *thingName* dikaitkan dengan atau dipisahkan dari jenis hal. *thingTypeName* Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup//*thingGroupName*hal//ditambahkan *thingName* | Langganan | AWS IoT menerbitkan ke topik ini ketika sesuatu *thingName* ditambahkan ke grup *thingGroupName* benda. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup/*thingGroupName*/thing/*thingName*/dihapus | Langganan | AWS IoT menerbitkan ke topik ini ketika sesuatu *thingName* dihapus dari grup *thingGroupName* benda. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup//*parentThingGroupName*/childThingGroup/*childThingGroupName*/ditambahkan | Langganan | AWS IoT menerbitkan ke topik ini ketika grup benda *childThingGroupName* ditambahkan ke grup *parentThingGroupName* benda. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup//*parentThingGroupName*childThingGroup/*childThingGroupName*/dihapus | Langganan | AWS IoT menerbitkan ke topik ini ketika grup sesuatu *childThingGroupName* dihapus dari grup *parentThingGroupName* benda. Untuk informasi selengkapnya, lihat [Peristiwa registri](registry-events.md). |
## Topik penyediaan armada
**catatan**
Operasi klien yang dicatat sebagai **Terima** dalam tabel ini menunjukkan topik yang AWS IoT diterbitkan langsung ke klien yang memintanya, apakah klien telah berlangganan topik atau tidak. Klien harus mengharapkan untuk menerima pesan respons ini bahkan jika mereka belum berlangganan. Pesan respons ini tidak melewati broker pesan dan mereka tidak dapat berlangganan oleh klien atau aturan lain.
Pesan-pesan ini mendukung buffer respons dalam format Concise Binary Object Representation (CBOR) dan JavaScript Object Notation (JSON), tergantung pada topik. *payload-format*
| *payload-format* | Jenis data format respons |
| --- | --- |
| cbor | Representasi Objek Biner Ringkas (CBOR) |
| json | JavaScript Notasi Objek (JSON) |
Untuk informasi selengkapnya, lihat [Penyediaan perangkat MQTT API](fleet-provision-api.md).
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1aws/certificates/create/*payload-format* | Publikasikan | Publikasikan ke topik ini untuk membuat sertifikat dari permintaan penandatanganan sertifikat (CSR). |
| \$1aws/certificates/create/*payload-format*/diterima | Berlangganan, Terima | AWS IoT menerbitkan ke topik ini setelah panggilan berhasil ke \$1aws/certificates/create/*payload-format*. |
| \$1aws/certificates/create/*payload-format*/ditolak | Berlangganan, Terima | AWS IoT menerbitkan ke topik ini setelah panggilan gagal ke \$1aws/certificates/create/. *payload-format* |
| \$1 aws/certificates/create -dari-csr/ *payload-format* | Publikasikan | Menerbitkan topik ini untuk membuat sertifikat dari CSR. |
| \$1 aws/certificates/create -dari-csr/ /diterima *payload-format* | Berlangganan, Terima | AWS IoT menerbitkan ke topik ini panggilan yang berhasil ke \$1 aws/certificates/create *payload-format* -from-csr/. |
| \$1 aws/certificates/create -dari-csr/ /ditolak *payload-format* | Berlangganan, Terima | AWS IoT menerbitkan ke topik ini panggilan yang gagal ke \$1 aws/certificates/create -from-csr/. *payload-format* |
| \$1 *templateName* aws/penyediaan-template//penyediaan/*payload-format* | Publikasikan | Publikasikan ke topik ini untuk mendaftarkan sesuatu. |
| \$1aws/provisioning-template//provision///diterima *templateName* *payload-format* | Berlangganan, Terima | AWS IoT menerbitkan ke topik ini setelah panggilan berhasil ke *templateName* \$1aws/provisioning-templates/ /provision/. *payload-format* |
| \$1aws/provisioning-templates/ /provision//ditolak *templateName* *payload-format* | Berlangganan, Terima | AWS IoT menerbitkan ke topik ini setelah panggilan gagal ke *templateName* \$1aws/provisioning-templates/ /provision/. *payload-format* |
## Topik Job
**catatan**
Operasi klien yang dicatat sebagai **Terima** dalam tabel ini menunjukkan topik yang AWS IoT diterbitkan langsung ke klien yang memintanya, apakah klien telah berlangganan topik atau tidak. Klien harus mengharapkan untuk menerima pesan respons ini bahkan jika mereka belum berlangganan.
Pesan respons ini tidak melewati broker pesan dan mereka tidak dapat berlangganan oleh klien atau aturan lain. Untuk berlangganan pesan terkait aktivitas pekerjaan, gunakan `notify` dan `notify-next` topik.
Saat berlangganan topik pekerjaan dan `jobExecution` acara untuk solusi pemantauan armada Anda, Anda harus terlebih dahulu mengaktifkan [acara pelaksanaan pekerjaan dan pekerjaan untuk menerima acara](iot-events.md) apa pun di sisi cloud.
Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md).
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1 aws/hal//pekerjaan/dapatkan *thingName* | Publikasikan | Perangkat mempublikasikan pesan ke topik ini untuk membuat `GetPendingJobExecutions` permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//*thingName*jobs/get/accepted | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan yang berhasil dari `GetPendingJobExecutions` permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//*thingName*jobs/get/rejected | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan saat `GetPendingJobExecutions` permintaan ditolak. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//pekerjaan/mulai-berikutnya *thingName* | Publikasikan | Perangkat mempublikasikan pesan ke topik ini untuk membuat `StartNextPendingJobExecution` permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//*thingName*jobs/start-next/accepted | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan yang berhasil `StartNextPendingJobExecution` atas permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//*thingName*jobs/start-next/rejected | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan saat `StartNextPendingJobExecution` permintaan ditolak. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//pekerjaan//dapatkan *thingName* *jobId* | Publikasikan | Perangkat mempublikasikan pesan ke topik ini untuk membuat `DescribeJobExecution` permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//pekerjaan//dapatkan/diterima *thingName* *jobId* | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan yang berhasil `DescribeJobExecution` atas permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//pekerjaan//dapatkan/ditolak *thingName* *jobId* | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan saat `DescribeJobExecution` permintaan ditolak. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 *thingName* aws/hal//pekerjaan//perbarui *jobId* | Publikasikan | Perangkat mempublikasikan pesan ke topik ini untuk membuat `UpdateJobExecution` permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 aws/hal//pekerjaan//pembaruan/diterima *thingName* *jobId* | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan yang berhasil `UpdateJobExecution` atas permintaan. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). Catatan Hanya perangkat yang menerbitkan ke \$1aws/things/ /jobs/ *thingName* *jobId* /update yang menerima pesan tentang topik ini. |
| \$1aws/things//jobs/ /update/ditolak *thingName* *jobId* | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima tanggapan saat `UpdateJobExecution` permintaan ditolak. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). Catatan Hanya perangkat yang menerbitkan ke \$1aws/things/ /jobs/ *thingName* *jobId* /update yang menerima pesan tentang topik ini. |
| \$1 aws/hal//pekerjaan/beri tahu *thingName* | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima pemberitahuan saat eksekusi pekerjaan ditambahkan atau dihapus ke daftar eksekusi yang tertunda untuk suatu hal. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1 *thingName* aws/hal//pekerjaan/beritahukan-berikutnya | Berlangganan, Terima | Perangkat berlangganan topik ini untuk menerima pemberitahuan ketika eksekusi pekerjaan tertunda berikutnya untuk hal tersebut diubah. Untuk informasi selengkapnya, lihat [Pekerjaan perangkat operasi MQTT API](jobs-mqtt-api.md). |
| \$1aws/events/job/*jobId*/selesai | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika pekerjaan selesai. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/*jobId*/dibatalkan | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika pekerjaan dibatalkan. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/*jobId*/dihapus | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika pekerjaan dihapus. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/*jobId*/cancellation\$1in\$1progress | Langganan | Layanan Pekerjaan menerbitkan acara tentang topik ini saat pembatalan pekerjaan dimulai. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/job/*jobId*/deletion\$1in\$1progress | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika penghapusan pekerjaan dimulai. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/berhasil | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika eksekusi pekerjaan berhasil. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/gagal | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika eksekusi pekerjaan gagal. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/ditolak | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika eksekusi pekerjaan ditolak. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/dibatalkan | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika eksekusi pekerjaan dibatalkan. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/timed\$1out | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika waktu eksekusi pekerjaan habis. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/dihapus | Langganan | Layanan Jobs memublikasikan peristiwa tentang topik ini saat eksekusi pekerjaan dihapus. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/dihapus | Langganan | Layanan Jobs menerbitkan acara tentang topik ini ketika eksekusi pekerjaan dihapus. Untuk informasi selengkapnya, lihat [Peristiwa tugas](events-jobs.md). |
## Topik perintah
**catatan**
Operasi klien yang dicatat sebagai **Terima** dalam tabel ini menunjukkan topik yang AWS IoT diterbitkan langsung ke klien yang memintanya, apakah klien telah berlangganan topik atau tidak. Klien harus mengharapkan untuk menerima pesan respons ini bahkan jika mereka belum berlangganan.
Pesan respons ini tidak melewati broker pesan dan mereka tidak dapat berlangganan oleh klien atau aturan lain.
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1aws/perintah///eksekusi//permintaan/******** \$1 aws/perintah///eksekusi//permintaan ** ** ** | Berlangganan, Terima | Perangkat menerima pesan tentang topik ini saat permintaan dibuat untuk memulai eksekusi perintah dari konsol atau menggunakan `StartCommandExecution` API. Dalam hal ini, ** dapat berupa hal IoT atau klien MQTT, dan ** dapat berupa nama benda IoT atau ID klien MQTT. |
| \$1aws/perintah///eksekusi//tanggapan/ ** ** ** ** | Publikasikan | Perangkat menggunakan `UpdateCommandExecution` MQTT API untuk mempublikasikan pesan ke topik ini tentang eksekusi perintah. Pesan dipublikasikan sebagai respons terhadap permintaan untuk memulai eksekusi perintah dari konsol atau menggunakan `StartCommandExecution` API. Pesan yang diterbitkan akan menggunakan JSON atau CBOR sebagai. ** |
| \$1aws/perintah///eksekusi//tanggap/diterima/ ** ** ** ** \$1aws/perintah///eksekusi//tanggapan/diterima ** ** ** | Berlangganan, Terima | Jika layanan cloud berhasil memproses hasil eksekusi perintah, AWS IoT Device Management menerbitkan respons terhadap topik /accepted. |
| \$1aws/perintah///eksekusi//tanggapan/ditolak/******** \$1aws/commands///eksekusi//tanggapan/ditolak ** ** ** | Publikasikan | Jika layanan cloud gagal memproses hasil eksekusi perintah, AWS IoT Device Management menerbitkan respons ke topik/ditolak. |
## Topik aturan
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1 aws/aturan/ *ruleName* | Publikasikan | Perangkat atau aplikasi menerbitkan topik ini untuk memicu aturan secara langsung. Untuk informasi selengkapnya, lihat [Mengurangi biaya pengiriman pesan dengan Basic Ingest](iot-basic-ingest.md). |
## Topik tunneling yang aman
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1 *thing-name* aws/things//tunnels/notify | Langganan | AWS IoT menerbitkan pesan ini untuk agen IoT untuk memulai proxy lokal di perangkat jarak jauh. Untuk informasi selengkapnya, lihat [Cuplikan agen IoT](configure-remote-device.md#agent-snippet). |
## Topik bayangan
Topik di bagian ini digunakan oleh bayangan bernama dan tidak disebutkan namanya. Topik yang digunakan oleh masing-masing hanya berbeda dalam awalan topik. Tabel ini menunjukkan awalan topik yang digunakan oleh setiap jenis bayangan.
| Nilai *ShadowTopicPrefix* | Jenis bayangan |
| --- | --- |
| \$1 aws/benda//bayangan thingName | Bayangan tanpa nama (klasik) |
| \$1 aws/hal//bayangan/nama/thingNameshadowName | Bernama bayangan |
Untuk membuat topik lengkap, pilih jenis bayangan yang ingin Anda rujuk, ganti *thingName* dan jika berlaku,*shadowName*, dengan nilai yang sesuai, lalu tambahkan dengan rintisan topik seperti yang ditunjukkan pada tabel berikut. *ShadowTopicPrefix* Ingatlah bahwa topik peka huruf besar/kecil.
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| *ShadowTopicPrefix*/hapus | Terbitkan/Berlangganan | Perangkat atau aplikasi menerbitkan topik ini untuk menghapus bayangan. Untuk informasi selengkapnya, lihat [/delete](device-shadow-mqtt.md#delete-pub-sub-topic). |
| *ShadowTopicPrefix*/hapus/diterima | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini saat bayangan dihapus. Untuk informasi selengkapnya, lihat [/delete/accepted](device-shadow-mqtt.md#delete-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/hapus/ditolak | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini saat permintaan untuk menghapus bayangan ditolak. Untuk informasi selengkapnya, lihat [/hapus/ditolak](device-shadow-mqtt.md#delete-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/dapatkan | Terbitkan/Berlangganan | Aplikasi atau sesuatu menerbitkan pesan kosong ke topik ini untuk mendapatkan bayangan. Untuk informasi selengkapnya, lihat [Topik MQTT Bayangan Perangkat](device-shadow-mqtt.md). |
| *ShadowTopicPrefix*/dapatkan/diterima | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini saat permintaan bayangan berhasil dibuat. Untuk informasi selengkapnya, lihat [/dapatkan/diterima](device-shadow-mqtt.md#get-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/dapatkan/ditolak | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini saat permintaan bayangan ditolak. Untuk informasi selengkapnya, lihat [/get/ditolak](device-shadow-mqtt.md#get-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/perbarui | Terbitkan/Berlangganan | Sesuatu atau aplikasi menerbitkan topik ini untuk memperbarui bayangan. Untuk informasi selengkapnya, lihat [/update](device-shadow-mqtt.md#update-pub-sub-topic). |
| *ShadowTopicPrefix*/perbarui/diterima | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini ketika pembaruan berhasil dibuat ke bayangan. Untuk informasi selengkapnya, lihat [/update/accepted](device-shadow-mqtt.md#update-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/perbarui/ditolak | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini saat pembaruan ke bayangan ditolak. Untuk informasi selengkapnya, lihat [/update/ditolak](device-shadow-mqtt.md#update-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/perbarui/delta | Langganan | Layanan Device Shadow mengirimkan pesan ke topik ini ketika perbedaan terdeteksi antara bagian bayangan yang dilaporkan dan yang diinginkan. Untuk informasi lebih lanjut, lihat [/update/delta](device-shadow-mqtt.md#update-delta-pub-sub-topic). |
| *ShadowTopicPrefix*/pembaruan/dokumen | Langganan | AWS IoT menerbitkan dokumen status ke topik ini setiap kali pembaruan bayangan berhasil dilakukan. Untuk informasi selengkapnya, lihat [/update/documents](device-shadow-mqtt.md#update-documents-pub-sub-topic). |
## Topik pengiriman file berbasis MQTT
**catatan**
Operasi klien yang dicatat sebagai **Terima** dalam tabel ini menunjukkan topik yang AWS IoT diterbitkan langsung ke klien yang memintanya, apakah klien telah berlangganan topik atau tidak. Klien harus mengharapkan untuk menerima pesan respons ini bahkan jika mereka belum berlangganan. Pesan respons ini tidak melewati broker pesan dan mereka tidak dapat berlangganan oleh klien atau aturan lain.
Pesan-pesan ini mendukung buffer respons dalam format Concise Binary Object Representation (CBOR) dan JavaScript Object Notation (JSON), tergantung pada topik. *payload-format*
| *payload-format* | Jenis data format respons |
| --- | --- |
| cbor | Representasi Objek Biner Ringkas (CBOR) |
| json | JavaScript Notasi Objek (JSON) |
| Topik | Operasi klien diizinkan | Deskripsi |
| --- | --- | --- |
| \$1 aws/hal//streaming//data/*ThingName**StreamId**payload-format* | Berlangganan, Terima | AWS Pengiriman file berbasis MQTT diterbitkan ke topik ini jika permintaan "GetStream" dari perangkat diterima. Muatan berisi data aliran. Untuk informasi selengkapnya, lihat [Menggunakan pengiriman AWS IoT file berbasis MQTT di perangkat](mqtt-based-file-delivery-in-devices.md). |
| \$1 aws/hal//streaming//dapatkan/*ThingName**StreamId**payload-format* | Publikasikan | Perangkat menerbitkan topik ini untuk melakukan permintaan GetStream "”. Untuk informasi selengkapnya, lihat [Menggunakan pengiriman AWS IoT file berbasis MQTT di perangkat](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/hal//streams/ /deskripsi/ *ThingName* *StreamId* *payload-format* | Berlangganan, Terima | AWS Pengiriman file berbasis MQTT diterbitkan ke topik ini jika permintaan "DescribeStream" dari perangkat diterima. Muatan berisi deskripsi aliran. Untuk informasi selengkapnya, lihat [Menggunakan pengiriman AWS IoT file berbasis MQTT di perangkat](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/hal//streams//deskripsikan/*ThingName**StreamId**payload-format* | Publikasikan | Perangkat menerbitkan topik ini untuk melakukan permintaan DescribeStream "”. Untuk informasi selengkapnya, lihat [Menggunakan pengiriman AWS IoT file berbasis MQTT di perangkat](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/hal//streams//ditolak/*ThingName**StreamId**payload-format* | Berlangganan, Terima | AWS Pengiriman file berbasis MQTT diterbitkan ke topik ini jika permintaan “” atau DescribeStream “GetStream” dari perangkat ditolak. Untuk informasi selengkapnya, lihat [Menggunakan pengiriman AWS IoT file berbasis MQTT di perangkat](mqtt-based-file-delivery-in-devices.md). |
## Topik cadangan ARN
Semua topik yang dicadangkan ARNs (Nama Sumber Daya Amazon) memiliki formulir berikut:
```
arn:aws:iot:aws-region:AWS-account-ID:topic/Topic
```
Misalnya, `arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted` adalah ARN untuk topik yang dicadangkan. `$aws/things/thingName/jobs/get/accepted`