Membuat dan menghapus rute dan titik akhir dengan menggunakan Azure PowerShell
Artikel ini memperlihatkan kepada Anda cara membuat rute dan titik akhir di hub Anda di Azure IoT Hub lalu menghapus rute dan titik akhir Anda. Pelajari cara menggunakan Azure PowerShell untuk membuat rute dan titik akhir untuk Azure Event Hubs, antrean dan topik Azure Bus Layanan, dan Azure Storage.
Untuk mempelajari selengkapnya tentang cara kerja perutean di IoT Hub, lihat Menggunakan perutean pesan IoT Hub untuk mengirim pesan perangkat ke cloud ke titik akhir yang berbeda. Untuk menelusuri penyiapan rute yang mengirim pesan ke penyimpanan lalu menguji pada perangkat yang disimulasikan, lihat Tutorial: Mengirim data perangkat ke Azure Storage dengan menggunakan perutean pesan IoT Hub.
Catatan
Saat ini, PowerShell tidak mendukung jenis autentikasi identitas terkelola untuk membuat titik akhir. Jika Anda tidak dapat menggunakan autentikasi SAS dalam skenario Anda, gunakan salah satu alat manajemen lainnya untuk membuat titik akhir.
Selain itu, PowerShell saat ini tidak mendukung pembuatan titik akhir Cosmos DB.
Prasyarat
Tinjau prasyarat untuk artikel ini berdasarkan jenis titik akhir yang ingin Anda rutekan pesannya.
Langganan Azure. Jika tidak memiliki langganan Azure, buat akun Azure gratis sebelum Anda memulai.
Hub IoT. Jika Anda tidak memiliki hub, Anda dapat mengikuti langkah-langkah untuk membuat hub IoT.
Azure PowerShell. Untuk menggunakan Azure PowerShell secara lokal, instal modul Azure PowerShell di komputer Anda. Atau, untuk menggunakan Azure PowerShell di browser web, aktifkan Azure Cloud Shell.
Sumber daya Azure Event Hubs (dengan kontainer). Jika Anda perlu membuat sumber daya Azure Event Hubs baru, lihat Mulai Cepat: Membuat hub peristiwa.
(Disarankan) Identitas terkelola dengan izin kontrol akses berbasis peran untuk namespace Layanan Pusat Aktivitas. Untuk informasi selengkapnya, lihat Mengautentikasi identitas terkelola dengan ID Microsoft Entra untuk mengakses sumber daya Azure Event Hubs.
Buat titik akhir
Di IoT Hub, Anda dapat membuat rute untuk mengirim pesan atau mengambil peristiwa. Setiap rute memiliki sumber data dan titik akhir. Sumber data adalah tempat asal pesan atau log peristiwa. Titik akhir adalah tempat pesan atau log peristiwa berakhir. Anda memilih lokasi untuk sumber data dan titik akhir saat membuat rute baru di hub IoT Anda. Kemudian, Anda menggunakan kueri perutean untuk memfilter pesan atau peristiwa sebelum masuk ke titik akhir.
Layanan yang Anda gunakan untuk membuat titik akhir harus terlebih dahulu ada di akun Azure Anda.
Catatan
Jika Anda menggunakan versi lokal Azure PowerShell, masuk ke Azure PowerShell sebelum Memulai.
Perintah dalam prosedur berikut menggunakan referensi ini:
Dapatkan string koneksi utama dari pusat aktivitas Anda. Salin string koneksi untuk digunakan nanti.
Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRuleBuat titik akhir hub IoT baru ke Azure Event Hubs. Gunakan string koneksi utama Anda dari langkah sebelumnya. Nilai untuk
EndpointTypeharusEventHub. Untuk semua parameter lainnya, gunakan nilai untuk skenario Anda.Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>"Untuk melihat semua opsi titik akhir perutean, lihat Add-AzIotHubRoutingEndpoint.
Membuat rute IoT Hub
Dengan titik akhir baru di hub IoT, Anda dapat membuat rute baru.
Rute fallback default di IoT Hub mengumpulkan pesan dari DeviceMessages. Pilih opsi yang berbeda untuk rute kustom Anda, seperti DeviceConnectionStateEvents. Untuk informasi selengkapnya tentang opsi sumber, lihat Add-AzIotHubRoute. Parameter Enabled adalah sakelar, jadi Anda tidak perlu menggunakan nilai dengan parameter .
Add-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -Source DeviceLifecycleEvents -EndpointName MyEndpoint -Enabled
PowerShell menampilkan konfirmasi yang terlihat mirip dengan contoh ini:
RouteName : MyIotHub
DataSource : DeviceLifecycleEvents
EndpointNames : MyEndpoint
Condition : true
IsEnabled : True
Memperbarui rute IoT Hub
Untuk membuat perubahan pada rute yang sudah ada, gunakan perintah berikut. Misalnya, coba ubah nama rute Anda dengan menggunakan perintah .
Set-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute
Get-AzIotHubRoute Gunakan perintah untuk mengonfirmasi perubahan rute Anda:
Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub
Menghapus titik akhir
Untuk menghapus titik akhir:
Remove-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -PassThru
Menghapus rute IoT Hub
Untuk menghapus rute IoT Hub:
Remove-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -PassThru
Tip
Menghapus rute tidak menghapus titik akhir apa pun di akun Azure Anda. Anda harus menghapus titik akhir secara terpisah dari menghapus rute.
Langkah berikutnya
Dalam artikel panduan ini, Anda mempelajari cara membuat rute dan titik akhir untuk Azure Event Hubs, Bus Layanan antrean dan topik, dan Azure Storage.
Untuk mempelajari selengkapnya tentang perutean pesan, lihat Tutorial: Mengirim data perangkat ke Azure Storage dengan menggunakan perutean pesan IoT Hub. Dalam tutorial, Anda membuat rute penyimpanan dan mengujinya dengan perangkat di hub IoT Anda.