Membuat dan membaca pesan IoT Hub

Untuk mendukung interoperabilitas di seluruh protokol, IoT Hub menentukan serangkaian fitur olahpesan umum yang tersedia di semua protokol yang menghadap perangkat. Fitur-fitur ini dapat digunakan dalam pesan perangkat-ke-cloud dan pesan cloud-ke-perangkat.

IoT Hub menerapkan olahpesan perangkat ke cloud menggunakan pola olah pesan streaming. Pesan perangkat-ke-cloud IoT Hub lebih seperti peristiwa Azure Event Hubs daripada Bus Layanan pesan karena ada volume peristiwa tinggi yang melewati layanan yang dapat dibaca oleh beberapa pembaca.

Pesan Azure IoT Hub terdiri dari:

• Sekumpulan properti sistem yang telah ditentukan sebelumnya seperti yang dijelaskan nanti di artikel ini.

• Sekumpulan properti aplikasi. Kamus properti string yang dapat didefinisikan dan diakses aplikasi, tanpa perlu mendeserialisasi isi pesan. IoT Hub tidak pernah mengubah properti ini.

• Isi pesan, yang dapat berupa semua jenis data.

Setiap protokol perangkat menerapkan properti pengaturan dengan cara yang berbeda. Untuk informasi selengkapnya, lihat panduan protokol MQTT dan panduan pengembang panduan protokol AMQP untuk detailnya.

Saat Anda mengirim pesan perangkat ke cloud menggunakan protokol HTTPS atau mengirim pesan cloud-ke-perangkat, nama dan nilai properti hanya dapat berisi karakter alfanumerik ASCII, ditambah ! # $ % & ' * + - . ^ _ ` | ~ .

Olahpesan perangkat ke cloud dengan IoT Hub memiliki karakteristik berikut:

• Pesan perangkat ke cloud tahan lama dan dipertahankan di titik akhir pesan/peristiwa default hub IoT selama maksimal tujuh hari.

• Ukuran pesan perangkat ke cloud maksimal 256 KB, dan dapat dikelompokkan dalam batch guna mengoptimalkan pengiriman. Batch maksimum bisa mencapai 256 KB.

• IoT Hub tidak mengizinkan pemartisian arbitrer. Pesan perangkat ke cloud dipartisi berdasarkan deviceId asalnya.

• Seperti yang dijelaskan dalam Akses kontrol IoT Hub, IoT Hub memungkinkan autentikasi per perangkat dan kontrol akses.

• Anda dapat memberi stempel pesan dengan informasi yang masuk ke dalam properti aplikasi. Untuk mengetahui informasi selengkapnya, baca pengayaan pesan.

Untuk menggunakan isi pesan Anda dalam kueri perutean IoT Hub, berikan objek JSON yang valid untuk pesan dan atur properti tipe konten pesan ke application/json;charset=utf-8.

Contoh berikut menunjukkan isi pesan yang valid dan dapat dirutekan:

{
    "timestamp": "2022-02-08T20:10:46Z",
    "tag_name": "spindle_speed",
    "tag_value": 100
}

Properti sistem pesan perangkat-ke-cloud

Properti aplikasi pesan perangkat-ke-cloud

Penggunaan umum properti aplikasi adalah mengirim tanda waktu dari perangkat menggunakan properti iothub-creation-time-utc yang akan direkam merekam saat pesan dikirim oleh perangkat. Format tanda waktu ini harus UTC tanpa informasi zona waktu. Misalnya, 2021-04-21T11:30:16Z valid, tetapi 2021-04-21T11:30:16-07:00 tidak valid.

{
  "applicationId":"00001111-aaaa-2222-bbbb-3333cccc4444",
  "messageSource":"telemetry",
  "deviceId":"sample-device-01",
  "schema":"default@v1",
  "templateId":"urn:modelDefinition:mkuyqxzgea:e14m1ukpn",
  "enqueuedTime":"2021-01-29T16:45:39.143Z",
  "telemetry":{
    "temperature":8.341033560421833
  },
  "messageProperties":{
    "iothub-creation-time-utc":"2021-01-29T16:45:39.021Z"
  },
  "enrichments":{}
}

Properti sistem pesan cloud-ke-perangkat

Nama properti sistem

Nama properti sistem bervariasi berdasarkan titik akhir tempat tujuan pesan dirutekan.

Ukuran pesan

IoT Hub mengukur ukuran pesan dengan cara agnostik protokol, dengan mempertimbangkan payload aktual saja. Ukuran dalam byte dihitung sebagai jumlah dari nilai berikut:

• Ukuran isi dalam byte.
• Ukuran dalam byte untuk semua nilai properti sistem pesan.
• Ukuran dalam byte untuk semua nama dan nilai properti pengguna.

Nama dan nilai properti terbatas pada karakter ASCII, sehingga panjang string sama dengan ukuran dalam byte.

Properti anti-spoofing

Untuk menghindari spoofing perangkat dalam pesan perangkat ke cloud, IoT Hub memberi stempel pada semua pesan dengan properti berikut:

• iothub-connection-device-id
• iothub-connection-auth-generation-id
• iothub-connection-auth-method

Dua properti pertama berisi deviceId dan generationId dari perangkat asal, sesuai Properti identitas perangkat.

Properti iothub-connection-auth-method berisi objek seri JSON, dengan properti berikut:

{
  "scope": "{ hub | device | module }",
  "type": "{ symkey | sas | x509 }",
  "issuer": "iothub"
}

Langkah berikutnya

• Untuk informasi tentang batas ukuran pesan di IoT Hub, lihat kuota dan pembatasan IoT Hub.
• Untuk mempelajari cara membuat dan membaca pesan IoT Hub dalam berbagai bahasa pemrograman, lihat Mulai cepat.
• Untuk mempelajari tentang struktur peristiwa non-telemetri yang dihasilkan oleh IoT Hub, lihat skema peristiwa non-telemetri IoT Hub.