Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menambahkan atribut penyebaran untuk pengayaan pesan
Di AWS IoT Core, Anda dapat memperkaya pesan MQTT dari perangkat dengan menambahkan atribut propagasi, yang merupakan metadata kontekstual dari atribut benda atau detail koneksi. Proses ini, yang dikenal sebagai pengayaan pesan, dapat membantu dalam berbagai skenario. Misalnya, Anda dapat memperkaya pesan untuk setiap operasi publikasi masuk tanpa membuat perubahan sisi perangkat atau perlu menggunakan aturan. Dengan memanfaatkan atribut propagating, Anda bisa mendapatkan keuntungan dari cara yang lebih efisien dan hemat biaya untuk memperkaya data IoT Anda tanpa kerumitan mengonfigurasi aturan atau mengelola konfigurasi penerbitan ulang.
[Fitur pengayaan pesan tersedia untuk AWS IoT Core pelanggan yang menggunakan [ingest dasar](https://docs.aws.amazon.com//iot/latest/developerguide/iot-basic-ingest.html) dan broker pesan.](https://docs.aws.amazon.com//iot/latest/developerguide/mqtt.html) Penting untuk dicatat saat perangkat penerbitan dapat menggunakan versi MQTT apa pun, pelanggan (aplikasi atau layanan yang menggunakan pesan) harus mendukung [MQTT 5](https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html) untuk menerima pesan yang diperkaya dengan atribut propagasi. Pesan yang diperkaya akan ditambahkan sebagai properti pengguna MQTT 5 ke setiap pesan yang diterbitkan dari perangkat. Jika Anda menggunakan [aturan](https://docs.aws.amazon.com//iot/latest/developerguide/iot-rules.html), Anda dapat memanfaatkan fungsi [get\$1user\$1properties](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-user-properties) untuk mengambil data yang diperkaya untuk perutean atau pemrosesan pesan berdasarkan data.
Di AWS IoT Core, Anda dapat menambahkan atribut propagasi saat Anda membuat atau memperbarui jenis sesuatu, dengan menggunakan Konsol Manajemen AWS atau. AWS CLI
**penting**
Saat menambahkan atribut propagasi, Anda harus memastikan bahwa klien yang menerbitkan pesan telah diautentikasi dengan sertifikat. Untuk informasi selengkapnya, lihat [Autentikasi Klien](client-authentication.md).
**catatan**
Jika Anda mencoba menguji fitur ini menggunakan klien pengujian MQTT dalam konsol, fitur ini mungkin tidak berfungsi karena fitur ini memerlukan klien MQTT yang diautentikasi dengan sertifikat terkait.
## Konsol Manajemen AWS
**Untuk menambahkan atribut propagasi untuk pengayaan pesan menggunakan Konsol Manajemen AWS**
1. Buka [AWS IoT halaman](https://console.aws.amazon.com//iot/home#/home) beranda di AWS IoT konsol. Di navigasi kiri, dari **Kelola**, pilih **Semua perangkat**. Kemudian pilih **Thing types**.
1. Pada halaman **Thing types**, pilih **Create thing type**.
Untuk mengonfigurasi pengayaan pesan dengan memperbarui jenis sesuatu, pilih jenis benda. Kemudian pada halaman detail tipe benda, pilih **Perbarui**.
1. Pada halaman **Create thing type**, pilih atau masukkan informasi tipe **benda di properti tipe Thing**.
Jika Anda memilih untuk memperbarui tipe sesuatu, Anda akan melihat **properti tipe Thing** setelah Anda memilih **Perbarui** pada langkah sebelumnya.
1. Dalam **konfigurasi Tambahan**, **perluas atribut Propagating**. Kemudian pilih **atribut Thing** dan masukkan atribut thing yang ingin Anda isi ke MQTT5 pesan yang dipublikasikan. Menggunakan konsol, Anda dapat menambahkan hingga tiga atribut hal.
Pada bagian **Propagating attributes**, pilih **atribut Connection** dan masukkan tipe atribut dan opsional nama atribut.
1. Secara opsional, tambahkan tag. Kemudian pilih **Create thing type**.
Jika Anda memilih untuk memperbarui jenis sesuatu, pilih **Perbarui jenis hal**.
## AWS CLI
1. Untuk menambahkan atribut propagasi untuk pengayaan pesan dengan membuat jenis hal baru menggunakan AWS CLI, jalankan perintah. [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html) Contoh perintah bisa sebagai berikut.
```
aws iot create-thing-type \
--thing-type-name "LightBulb" \
--thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \
```
Output dari perintah dapat terlihat seperti berikut.
```
{
"thingTypeName": "LightBulb",
"thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
"thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190"
}
```
1. Untuk mengonfigurasi pengayaan pesan dengan memperbarui tipe benda menggunakan AWS CLI, jalankan perintah. [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-type.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-type.html) Perhatikan bahwa Anda hanya dapat memperbarui `mqtt5Configuration` ketika Anda menjalankan perintah ini. Contoh perintah bisa sebagai berikut.
```
aws iot update-thing-type \
--thing-type-name "MyThingType" \
--thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \
```
Perintah ini tidak menghasilkan output apa pun.
1. Untuk mendeskripsikan tipe benda, jalankan `describe-thing-type` perintah. Perintah ini akan menghasilkan output dengan informasi konfigurasi pengayaan pesan di lapangan. `thing-type-properties` Contoh perintah bisa sebagai berikut.
```
aws iot describe-thing-type \
--thing-type-name "LightBulb"
```
Outputnya bisa terlihat seperti berikut ini.
```
{
"thingTypeName": "LightBulb",
"thingTypeId": "bdf72512-0116-4392-8d79-bf39b17ef73d",
"thingTypeArn": "arn:aws:iot:us-east-1:123456789012:thingtype/LightBulb",
"thingTypeProperties": {
"mqtt5Configuration": {
"propagatingAttributes": [
{
"userPropertyKey": "iot:ClientId",
"connectionAttribute": "iot:ClientId"
},
{
"userPropertyKey": "test",
"thingAttribute": "attribute"
}
]
}
},
"thingTypeMetadata": {
"deprecated": false,
"creationDate": "2024-10-18T17:37:46.656000+00:00"
}
}
```
Lihat informasi yang lebih lengkap di [Jenis benda](thing-types.md).