Referensi - Titik akhir IoT Hub

Catatan

Beberapa fitur yang disebutkan dalam artikel ini, seperti pesan cloud-ke-perangkat, kembar perangkat, dan manajemen perangkat, hanya tersedia di tingkat standar IoT Hub. Untuk mengetahui informasi selengkapnya tentang tingkat IoT Hub standar dan dasar, lihat Cara memilih tingkat IoT Hub yang tepat.

Nama IoT Hub

Anda dapat menemukan nama host hub IoT yang menghosting titik akhir Anda di portal di halaman Gambaran Umum hub Anda. Secara default, nama DNS IoT Hub terlihat seperti: {your iot hub name}.azure-devices.net.

Daftar titik akhir IoT Hub bawaan

Azure IoT Hub adalah layanan multi-penyewa yang mengekspos fungsinya ke berbagai aktor. Diagram berikut menunjukkan berbagai titik akhir yang diekspos IoT Hub.

IoT Hub endpoints

Daftar berikut ini menjelaskan titik akhir:

  • Penyedia Sumber. Penyedia sumber IoT Hub mengekspos antarmuka Azure Resource Manager. Antarmuka ini memungkinkan pemilik langganan Azure membuat dan menghapus IoT Hub, dan memperbarui properti IoT Hub. Properti IoT Hub mengatur kebijakan keamanan tingkat hub, yang bertentangan dengan kontrol akses tingkat perangkat, dan opsi fungsional untuk perpesanan cloud-ke-perangkat dan perangkat-ke-cloud. Penyedia sumber IoT Hub juga memungkinkan Anda mengekspor identitas perangkat.

  • Manajemen identitas perangkat. Setiap IoT Hub mengekspos sekumpulan titik akhir HTTPS REST untuk mengelola identitas perangkat (membuat, mengambil, memperbarui, dan menghapus). Identitas perangkat digunakan untuk autentikasi perangkat dan kontrol akses.

  • Manajemen perangkat ganda. Setiap IoT Hub mengekspos sekumpulan titik akhir HTTPS REST yang berhubungan dengan layanan untuk mengkueri dan memperbarui perangkat ganda (memperbarui tag dan properti).

  • Manajemen pekerjaan. Setiap IoT Hub mengekspos sekumpulan titik akhir HTTPS REST yang berhubungan dengan layanan untuk mengkueri dan mengelola pekerjaan.

  • Titik akhir perangkat. Untuk setiap perangkat dalam registri identitas, IoT Hub mengekspos sekumpulan titik akhir. Kecuali jika disebutkan, titik akhir ini diekspos menggunakan protokol MQTT v3.1.1, HTTPS 1.1, dan AMQP 1.0. AMQP dan MQTT juga tersedia melalui WebSocket di port 443.

    • Mengirim pesan perangkat-ke- cloud. Perangkat menggunakan titik akhir ini untuk mengirim pesan perangkat-ke-cloud.

    • Menerima pesan cloud-ke-perangkat. Perangkat menggunakan titik akhir ini untuk menerima pesan cloud-ke-perangkat yang ditargetkan.

    • Memulai unggahan file. Perangkat menggunakan titik akhir ini untuk menerima URI SAS Azure Storage dari IoT Hub untuk mengunggah file.

    • Mengambil dan memperbarui properti perangkat ganda. Perangkat menggunakan titik akhir ini untuk mengakses properti perangkat gandanya. HTTPS tidak didukung.

    • Menerima permintaan metode langsung. Perangkat menggunakan titik akhir ini untuk mendengarkan permintaan metode langsung. HTTPS tidak didukung.

    Penting

    Fungsionalitas berikut untuk perangkat yang menggunakan autentikasi otoritas sertifikat (CA) X.509 belum tersedia secara umum, dan mode pratinjau harus diaktifkan:

    • HTTPS, MQTT melalui WebSocket, dan AMQP melalui protokol WebSockets.
    • Unggahan file (semua protokol).

    Hal ini umumnya tersedia pada perangkat yang menggunakan autentikasi sidik jari X.509. Untuk mempelajari selengkapnya tentang autentikasi X.509 dengan IoT Hub, lihat Sertifikat X.509 yang didukung.

  • Titik akhir layanan. Setiap IoT Hub mengekspos sekelompok titik akhir untuk back end solusi Anda untuk berkomunikasi dengan perangkat Anda. Dengan satu pengecualian, titik akhir ini hanya diekspos menggunakan AMQP dan AMQP melalui protokol WebSockets. Titik akhir pemanggilan metode langsung diekspos melalui protokol HTTPS.

    • Menerima pesan perangkat-ke-cloud. Titik akhir ini kompatibel dengan Azure Event Hubs. Layanan back-end dapat menggunakannya untuk membaca pesan perangkat-ke-cloud yang dikirim oleh perangkat Anda. Anda dapat membuat titik akhir kustom di IoT Hub Anda selain titik akhir bawaan ini.

    • Mengirim pesan cloud-ke-perangkat dan menerima pengakuan pengiriman. Titik akhir ini memungkinkan back end solusi Anda untuk mengirim pesan cloud-ke-perangkat yang andal, dan untuk menerima pengiriman atau pengakuan kedaluwarsa yang sesuai.

    • Menerima pemberitahuan file. Titik akhir perpesanan ini memungkinkan Anda menerima pemberitahuan kapan perangkat Anda berhasil mengunggah file.

    • Pemanggilan metode langsung. Titik akhir ini memungkinkan layanan back-end untuk memanggil metode langsung pada perangkat.

    • Menerima peristiwa pemantauan operasi. Titik akhir ini memungkinkan Anda menerima peristiwa pemantauan operasi jika IoT Hub Anda telah dikonfigurasi untuk memancarkannya. Untuk informasi selengkapnya, lihat Pemantauan operasi IoT Hub.

Artikel SDK Azure IoT menjelaskan berbagai cara untuk mengakses titik akhir ini.

Semua titik akhir IoT Hub menggunakan protokol TLS, dan tidak ada titik akhir yang pernah diekspos pada saluran yang tidak terenkripsi/tidak aman.

Titik akhir kustom

Anda dapat menautkan layanan Azure yang ada di langganan Azure ke IoT Hub Anda untuk bertindak sebagai titik akhir untuk perutean pesan. Titik akhir ini bertindak sebagai titik akhir layanan dan digunakan sebagai sink untuk rute pesan. Perangkat tidak dapat menulis secara langsung ke titik akhir tambahan. Pelajari selengkapnya tentang perutean pesan.

IoT Hub saat ini mendukung layanan Azure berikut sebagai titik akhir tambahan:

  • Kontainer Azure Storage
  • Event Hubs
  • Antrean Azure Service Bus
  • Topik Azure Service Bus

Untuk batas jumlah titik akhir yang dapat Anda tambahkan, lihat Kuota dan pembatasan.

Kesehatan Titik Akhir

Anda dapat menggunakan REST API Dapatkan Kesehatan Titik Akhir untuk mendapatkan status kesehatan titik akhir. Sebaiknya gunakan metrik perutean Azure IoT Hub yang terkait dengan latensi pesan perutean untuk mengidentifikasi dan men-debug kesalahan ketika kesehatan titik akhir mati atau tidak sehat, karena kami mengharapkan latensi menjadi lebih tinggi ketika titik akhir berada di salah satu kondisi bagian tersebut. Untuk mempelajari selengkapnya tentang penggunaan metrik Azure IoT Hub, lihat Pantau Azure IoT Hub.

Status Kesehatan Deskripsi
sehat Titik akhir menerima pesan seperti yang diharapkan.
tidak sehat Titik akhir tidak menerima pesan dan Azure IoT Hub mencoba mengirim pesan ke titik akhir ini.
tidak diketahui Azure IoT Hub belum mencoba mengirimkan pesan ke titik akhir ini.
diturunkan Titik akhir menerima pesan lebih lambat dari yang diharapkan atau pulih dari keadaan tidak sehat.
mati Azure IoT Hub tidak lagi mengirimkan pesan ke titik akhir ini. Upaya untuk mengirim pesan ke titik akhir ini gagal.

Gateway bidang

Dalam solusi IoT, gateway bidang berada di antara perangkat Anda dan titik akhir IoT Hub Anda. Biasanya terletak dekat dengan perangkat Anda. Perangkat Anda berkomunikasi langsung dengan gateway bidang dengan menggunakan protokol yang didukung oleh perangkat. Gateway bidang tersambung ke titik akhir IoT Hub menggunakan protokol yang didukung oleh IoT Hub. Gateway bidang mungkin merupakan perangkat keras khusus atau komputer berdaya rendah yang menjalankan perangkat lunak gateway kustom.

Anda dapat menggunakan Azure IoT Edge untuk mengimplementasikan gateway bidang. IoT Edge menawarkan fungsionalitas seperti komunikasi multiplexing dari beberapa perangkat ke koneksi IoT Hub yang sama.

Langkah berikutnya

Topik referensi lain dalam panduan pengembang IoT Hub ini meliputi: