Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 dan broker pesan. Penting untuk dicatat saat perangkat penerbitan dapat menggunakan versi MQTT apa pun, pelanggan (aplikasi atau layanan yang menggunakan pesan) harus mendukung MQTT 5
Di AWS IoT Core, Anda dapat menambahkan atribut propagasi saat Anda membuat atau memperbarui jenis sesuatu, dengan menggunakan AWS Management Console 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.
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.
AWS Management Console
Untuk menambahkan atribut propagasi untuk pengayaan pesan menggunakan AWS Management Console
-
Buka AWS IoT halaman
beranda di AWS IoT konsol. Di navigasi kiri, dari Kelola, pilih Semua perangkat. Kemudian pilih Thing types. -
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.
-
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.
-
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.
-
Secara opsional, tambahkan tag. Kemudian pilih Create thing type.
Jika Anda memilih untuk memperbarui jenis sesuatu, pilih Perbarui jenis hal.
AWS CLI
-
Untuk menambahkan atribut propagasi untuk pengayaan pesan dengan membuat jenis hal baru menggunakan AWS CLI, jalankan perintah. create-thing-type
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" } -
Untuk mengonfigurasi pengayaan pesan dengan memperbarui tipe benda menggunakan AWS CLI, jalankan perintah. update-thing-type
Perhatikan bahwa Anda hanya dapat memperbarui mqtt5Configurationketika 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.
-
Untuk menggambarkan tipe sesuatu, jalankan
describe-thing-typeperintah. Perintah ini akan menghasilkan output dengan informasi konfigurasi pengayaan pesan di lapangan.thing-type-propertiesContoh 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" } }
Untuk informasi selengkapnya, lihat Jenis benda.
