Membaca pesan perangkat-ke-cloud dari titik akhir bawaan
Secara default, pesan dirutekan ke titik akhir yang menghadap layanan bawaan(pesan/peristiwa)yang kompatibel dengan Pusat Aktivitas. Azure IoT Hub memaparkan titik akhir bawaan pesan/peristiwa untuk layanan back-end Anda untuk membaca pesan perangkat-ke-cloud yang diterima oleh hub Anda. Titik akhir ini kompatibel dengan Azure Event Hubs, yang memungkinkan Anda menggunakan salah satu mekanisme yang didukung layanan Azure Event Hubs untuk membaca pesan.
Jika Anda menggunakan perutean pesan dan rute fallback diaktifkan, pesan yang tidak cocok dengan kueri pada rute apa pun masuk ke titik akhir bawaan. Jika Anda menonaktifkan rute fallback ini, pesan yang tidak cocok dengan kueri apa pun akan dihilangkan.
Titik akhir ini saat ini hanya diekspos menggunakan protokol AMQP pada port 5671 dan AMQP melalui WebSockets pada port 443. Azure IoT Hub mengekspos properti berikut ini untuk membuat Anda dapat mengontrol pesan/peristiwa titik akhir pesan Pusat Aktivitas yang kompatibel bawaan.
| Properti | Deskripsi |
|---|---|
| Jumlah partisi | Atur properti ini saat dibuat untuk menentukan jumlah partisi untuk penyerapan peristiwa perangkat-ke-cloud. |
| Waktu retensi | Properti ini menentukan berapa lama dalam hari pesan dipertahankan oleh Azure IoT Hub. Defaultnya adalah satu hari, tetapi dapat ditingkatkan menjadi tujuh hari. |
IoT Hub memungkinkan retensi data di titik akhir bawaan selama maksimal tujuh hari. Anda dapat mengatur waktu retensi selama pembuatan hub IoT Anda. Waktu retensi data di Azure IoT Hub tergantung pada tingkat Azure IoT Hub dan jenis unit Anda. Dalam hal ukuran, titik akhir bawaan dapat menyimpan pesan dengan ukuran pesan maksimum hingga setidaknya 24 jam kuota. Misalnya, satu hub IoT unit S1 menyediakan penyimpanan yang cukup untuk mempertahankan setidaknya 400.000 pesan, pada 4 KB per pesan. Jika perangkat Anda mengirim pesan yang lebih kecil, perangkat tersebut dapat dipertahankan lebih lama (hingga tujuh hari) tergantung pada berapa banyak penyimpanan yang digunakan. Kami menjamin untuk menyimpan data untuk waktu retensi yang ditentukan minimal. Setelah waktu retensi berlalu, pesan kedaluwarsa dan menjadi tidak dapat diakses. Anda dapat memodifikasi waktu retensi, baik secara terprogram menggunakan Penyedia sumber daya Azure IoT Hub REST API, atau dengan portal Microsoft Azure.
IoT Hub juga memungkinkan Anda mengelola grup konsumen pada titik akhir bawaan. Anda dapat memiliki hingga 20 grup konsumen untuk setiap hub IoT.
Koneksi ke titik akhir bawaan
Beberapa integrasi produk dan SDK Pusat Aktivitas mengetahui Azure IoT Hub dan memungkinkan Anda menggunakan string koneksi layanan Azure IoT Hub Anda untuk terhubung ke titik akhir bawaan.
Saat Anda menggunakan SDK Pusat Aktivitas atau integrasi produk yang tidak menyadari Azure IoT Hub, Anda memerlukan titik akhir yang kompatibel dengan Pusat Aktivitas dan nama yang kompatibel dengan Pusat Aktivitas. Anda dapat mengambil nilai-nilai ini dari portal sebagai berikut:
Masuk ke portal Azure dan navigasikan ke IoT hub Anda.
Pilih Titik akhir bawaan dari menu sumber daya, di bawah Pengaturan hub.
Panel kerja titik akhir bawaan berisi tiga bagian:
- Bagian Detail Pusat Aktivitas berisi nilai berikut: Partisi, nama yang kompatibel dengan Pusat Aktivitas, Pertahankan untuk, dan Grup Konsumen.
- Bagian titik akhir yang kompatibel dengan Event Hub berisi nilai berikut: Kebijakan akses bersama dan titik akhir yang kompatibel dengan Event Hub.
- Bagian Olahpesan cloud ke perangkat berisi nilai berikut: TTL Default, Waktu retensi umpan balik, dan Jumlah pengiriman maksimum.
Di panel kerja, bidang titik akhir yang kompatibel dengan Pusat Aktivitas berisi string koneksi Azure Event Hubs lengkap yang terlihat seperti contoh berikut:
Titik akhir=sb://abcd1234namespace.servicebus.windows.net/; SharedAccessKeyName=iothubowner; SharedAccessKey=keykeykeykeykey=; EntityPath=iothub-ehub-abcd-1234-123456
Jika SDK yang Anda gunakan memerlukan nilai lain, maka nilai tersebut adalah:
| Nama | Nilai |
|---|---|
| Titik akhir | sb://abcd1234namespace.servicebus.windows.net/ |
| Nama host | abcd1234namespace.servicebus.windows.net |
| Ruang nama | abcd1234namespace |
Anda kemudian dapat memilih kebijakan akses bersama dari menu drop-down Kebijakan akses bersama, seperti yang ditunjukkan pada cuplikan layar sebelumnya. Ini hanya menampilkan kebijakan yang memiliki izin Layanan Koneksi untuk menyambungkan ke hub peristiwa yang ditentukan.
Sampel SDK
SDK yang dapat Anda gunakan untuk menyambungkan ke titik akhir Pusat Peristiwa yang kompatibel bawaan yang diekspos oleh Azure IoT Hub meliputi:
Integrasi produk yang dapat Anda gunakan dengan titik akhir Pusat Kejadian yang kompatibel bawaan yang diekspos oleh Azure IoT Hub meliputi:
-
Untuk informasi selengkapnya, lihat Pengikatan Azure IoT Hub untuk Azure Functions.
-
Untuk informasi selengkapnya, lihat Mengalirkan data sebagai input ke Azure Stream Analytics.
-
Untuk informasi selengkapnya, lihat Menambahkan sumber peristiwa hub IoT ke lingkungan Azure Time Series Insight Anda.
-
Untuk informasi selengkapnya, lihat panduan pengembang Apache Kafka untuk Azure Event Hubs.
Langkah berikutnya
Untuk informasi selengkapnya tentang titik akhir IoT Hub, lihat titik akhir IoT Hub.
Jika Anda ingin merutekan pesan perangkat-ke-cloud ke titik akhir kustom, lihat Menggunakan rute pesan dan titik akhir kustom untuk pesan perangkat-ke-cloud.