View a markdown version of this page

Menambahkan atribut penyebaran untuk pengayaan pesan - AWS IoT Core
Konsol Manajemen AWSAWS CLI

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 penyebaran, 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 penerbitan masuk tanpa membuat perubahan sisi perangkat atau perlu menggunakan aturan. Dengan memanfaatkan atribut penyebaran, Anda dapat memperoleh manfaat 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 perantara menelan dasar dan broker https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html pesan. Penting untuk dicatat sementara perangkat penerbitan dapat menggunakan versi MQTT apa pun, pelanggan (aplikasi atau layanan yang memakan pesan) harus mendukung MQTT 5 untuk menerima pesan yang diperkaya dengan atribut penyebaran. Pesan yang diperkaya akan ditambahkan sebagai properti pengguna MQTT 5 ke setiap pesan yang diterbitkan dari perangkat. Jika Anda menggunakan aturan, Anda dapat memanfaatkan fungsi get_user_properties untuk mengambil data yang diperkaya untuk perutean pesan atau pemrosesan berdasarkan data.

Di AWS IoT Core, Anda dapat menambahkan atribut penyebaran saat Anda membuat atau memperbarui jenis benda, dengan menggunakan Konsol Manajemen AWS atau. AWS CLI

penting

Saat menambahkan atribut penyebaran, 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 uji MQTT di dalam konsol, fitur ini mungkin tidak berfungsi karena fitur ini memerlukan klien MQTT yang diautentikasi dengan sertifikat terkait.

Konsol Manajemen AWS

Untuk menambahkan atribut penyebaran untuk pengayaan pesan menggunakan Konsol Manajemen AWS

  1. Buka halaman AWS IoT ber anda di AWS IoT konsol. Di navigasi kiri, dari Kelola, pilih Semua perangkat. Kemudian pilih Jenis benda.

  2. Pada halaman Jenis benda, pilih Buat jenis benda.

    Untuk mengonfigurasi pengayaan pesan dengan memperbarui jenis benda, pilih jenis benda. Kemudian pada halaman detail jenis hal, pilih Per barui.

  3. Pada halaman Buat jenis benda, pilih atau masukkan informasi jenis benda di properti tipe benda.

    Jika Anda memilih untuk memperbarui jenis benda, Anda akan melihat properti tipe benda setelah Anda memilih Per barui pada langkah sebelumnya.

  4. Di Konfigurasi tambahan, perluas Men yebarkan atribut. Kemudian pilih atribut Thing dan masukkan atribut benda yang ingin Anda isi ke pesan MQTT5 yang diterbitkan. Dengan menggunakan konsol, Anda dapat menambahkan hingga tiga atribut hal.

    Pada bagian Menyebarkan atribut, pilih atribut koneksi dan masukkan jenis atribut dan secara opsional nama atribut.

  5. Secara opsional, tambahkan tag. Kemudian pilih Create thing type.

    Jika Anda memilih untuk memperbarui jenis benda, pilih Per barui jenis benda.

AWS CLI

  1. Untuk menambahkan atribut penyebaran untuk pengayaan pesan dengan membuat tipe benda 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 ini.

    {
	"thingTypeName": "LightBulb",
	"thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
	"thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190"
}

  2. Untuk mengkonfigurasi pengayaan pesan dengan memperbarui jenis benda menggunakan AWS CLI, jalankan perintah update-th ing-type. 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.

  3. Untuk menggambarkan jenis sesuatu, jalankan describe-thing-type perintah. Perintah ini akan menghasilkan output dengan informasi konfigurasi pengayaan pesan di thing-type-properties lapangan. 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.