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 antrean dan topik Azure Event Hubs, Azure Service Bus, 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.

Prasyarat

Prosedur yang dijelaskan dalam artikel menggunakan sumber daya berikut:

• Azure PowerShell
• Sebuah hub IoT
• Layanan titik akhir di Azure

Azure PowerShell

Artikel ini menggunakan Azure PowerShell untuk bekerja dengan IoT Hub dan layanan Azure lainnya. 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.

IoT hub

Untuk membuat rute hub IoT, Anda memerlukan hub IoT yang Anda buat dengan menggunakan Azure IoT Hub. Pesan perangkat dan log peristiwa berasal dari hub IoT Anda.

Pastikan untuk memiliki sumber daya hub berikut untuk digunakan saat Anda membuat rute hub IoT Anda:

• Hub IoT di langganan Azure Anda. Jika Anda belum memiliki hub, Anda dapat mengikuti langkah-langkah untuk membuat hub IoT dengan menggunakan cmdlet PowerShell New-AzIotHub.

Layanan titik akhir

Untuk membuat rute hub IoT, Anda memerlukan setidaknya satu layanan Azure lainnya untuk digunakan sebagai titik akhir ke rute. Titik akhir menerima pesan perangkat dan log peristiwa. Anda dapat memilih layanan Azure mana yang Anda gunakan untuk titik akhir untuk terhubung dengan rute hub IoT Anda: Azure Event Hubs, antrean atau topik Azure Service Bus, atau Azure Storage.

Pastikan untuk memiliki salah satu sumber daya berikut untuk digunakan saat Anda membuat titik akhir rute hub IoT Anda:

• Sumber daya Azure Event Hubs (dengan kontainer). Jika Anda perlu membuat sumber daya Azure Event Hubs baru, lihat Mulai Cepat: Membuat hub peristiwa dengan menggunakan Azure PowerShell.

• Sumber daya antrean Azure Service Bus. Jika Anda perlu membuat antrean Bus Layanan baru, lihat Menggunakan Azure PowerShell untuk membuat namespace dan antrean Bus Layanan.

• Sumber daya topik Bus Layanan. Jika Anda perlu membuat topik Bus Layanan baru, lihat referensi New-AzServiceBusTopic dan dokumentasi olahpesan Azure Service Bus.

• Sumber daya Azure Storage. Jika Anda perlu membuat akun penyimpanan baru di Azure, lihat Membuat akun penyimpanan.

Membuat sumber daya dan 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.

Anda dapat menggunakan pusat aktivitas, antrean atau topik Azure Service Bus, atau akun penyimpanan untuk menjadi titik akhir untuk rute hub IoT Anda. Layanan yang Anda gunakan untuk membuat titik akhir harus ada terlebih dahulu di akun Azure Anda.

Catatan

Jika Anda menggunakan versi lokal Azure PowerShell, masuk ke Azure PowerShell sebelum memulai.

Event Hubs

Perintah dalam prosedur berikut menggunakan referensi ini:

• Az.IotHub
• Az.EventHub

Membuat pusat aktivitas

Untuk membuat sumber daya Azure Event Hubs baru yang memiliki aturan otorisasi:

1. Buat namespace layanan Azure Event Hubs baru. Untuk NamespaceName, gunakan nilai unik.

   New-AzEventHubNamespace -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Location MyLocation
   

2. Buat entitas Azure Event Hubs baru Anda. Untuk Name, gunakan nilai unik. Untuk NamespaceName, gunakan nama namespace layanan yang Anda buat di langkah sebelumnya.

   New-AzEventHub -Name MyEventHub -NamespaceName MyNamespace -ResourceGroupName MyResourceGroup
   

3. Buat aturan otorisasi baru. Untuk Name, gunakan nama entitas Anda untuk EventHubName. Untuk nama aturan otorisasi Anda, gunakan nilai unik.

   New-AzEventHubAuthorizationRule -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule -Rights @('Manage', 'Send', 'Listen')
   

   Untuk informasi selengkapnya tentang akses, lihat Mengotorisasi akses ke Azure Event Hubs.

Membuat titik akhir Azure Event Hubs

1. Dapatkan string koneksi utama dari pusat aktivitas Anda. Salin string koneksi untuk digunakan nanti.

   Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule
   

2. Buat titik akhir hub IoT baru ke Azure Event Hubs. Gunakan string koneksi utama Anda dari langkah sebelumnya. Nilai untuk EndpointType harus EventHub. 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.

Antrean Microsoft Azure Service Bus

Perintah dalam prosedur berikut menggunakan referensi ini:

• Az.IotHub
• Az.ServiceBus

Membuat namespace dan antrean Azure Service Bus

Untuk membuat sumber daya antrean Bus Layanan baru:

1. Buat namespace Azure Service Bus baru. Untuk Name, gunakan nilai unik.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Buat antrean Bus Layanan baru. Untuk NamespaceName, gunakan nama namespace layanan yang Anda buat di langkah sebelumnya. Untuk nama antrean Anda, gunakan nilai unik.

   New-AzServiceBusQueue -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyQueue
   

Membuat titik akhir antrean Azure Service Bus

Untuk membuat titik akhir antrean Bus Layanan baru:

1. Ambil string koneksi utama dari namespace Bus Layanan Anda. Salin string koneksi untuk digunakan nanti.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Buat titik akhir hub IoT baru ke antrean Azure Service Bus Anda. Gunakan string koneksi utama Anda dari langkah sebelumnya dengan ;EntityPath=MyServiceBusQueue ditambahkan ke akhir. Nilai untuk EndpointType harus ServiceBusQueue. Untuk semua parameter lainnya, gunakan nilai untuk skenario Anda. Untuk EndpointName, gunakan nilai unik.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=my-connection-string;EntityPath=MyServiceBusQueue"
   

   Untuk daftar semua opsi titik akhir perutean, lihat Add-AzIotHubRoutingEndpoint.

Topik Microsoft Azure Service Bus

Perintah dalam prosedur berikut menggunakan referensi ini:

• Az.IotHub
• Az.ServiceBus

Dengan topik Azure Service Bus , pengguna dapat berlangganan satu atau beberapa topik. Untuk membuat topik, Anda juga membuat namespace dan langganan Bus Layanan.

Membuat namespace, topik, dan langganan Azure Service Bus

1. Buat namespace Azure Service Bus baru. Untuk Name namespace Anda, gunakan nilai unik.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Buat topik Bus Layanan baru. Untuk nama topik, gunakan nilai unik.

   New-AzServiceBusTopic -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyTopic
   

3. Buat langganan baru ke topik Anda. Untuk TopicName, gunakan nama topik yang Anda buat di langkah sebelumnya. Untuk nama langganan Anda, gunakan nilai unik.

   New-AzServiceBusSubscription -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -TopicName MyTopic -Name MySubscription
   

Membuat titik akhir topik Bus Layanan

1. Ambil string koneksi utama dari namespace Bus Layanan Anda. Salin string koneksi untuk digunakan nanti.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Buat titik akhir hub IoT baru ke topik Bus Layanan Anda. Gunakan string koneksi utama Anda dari langkah sebelumnya dengan ;EntityPath=MyServiceBusTopic ditambahkan ke akhir. Nilai untuk EndpointType harus ServiceBusTopic. Untuk semua parameter lainnya, gunakan nilai untuk skenario Anda. Untuk EndpointName, gunakan nilai unik.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType ServiceBusTopic -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>;EntityPath=MyServiceBusTopic"
   

   Untuk daftar semua opsi titik akhir perutean, lihat Add-AzIotHubRoutingEndpoint.

Azure Storage

Perintah dalam prosedur berikut menggunakan referensi ini:

• Az.IotHub
• Az.Storage

Untuk membuat titik akhir dan rute Azure Storage, Anda memerlukan akun dan kontainer Storage.

Membuat akun dan kontainer Azure Storage

1. Buat akun Microsoft Azure Storage baru. Nilai Name untuk akun penyimpanan Anda hanya dapat berisi huruf kecil dan angka. Untuk SkuName opsi, lihat SkuName.

   New-AzStorageAccount -ResourceGroupName MyResourceGroup -Name mystorageaccount -Location westus -SkuName Standard_GRS
   

2. Buat kontainer baru di akun penyimpanan Anda. Anda perlu membuat konteks ke akun penyimpanan Anda dalam variabel, lalu menambahkan variabel ke Context parameter . Untuk mempelajari tentang opsi Anda saat membuat kontainer, lihat Mengelola kontainer blob dengan menggunakan PowerShell. Untuk Name, gunakan nilai unik untuk nama kontainer Anda.

   $ctx = New-AzStorageContext -StorageAccountName mystorageaccount -UseConnectedAccount `
   New-AzStorageContainer -Name ContainerName -Context $ctx
   

Membuat titik akhir Azure Storage

Untuk membuat titik akhir ke Azure Storage, Anda memerlukan kunci akses untuk membuat string koneksi. String koneksi kemudian merupakan bagian dari perintah IoT Hub untuk membuat titik akhir.

1. Ambil kunci akses Anda dari akun penyimpanan Anda, lalu salin.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Buat string koneksi utama untuk akun penyimpanan Anda berdasarkan templat berikut. Ganti mystorageaccount (di dua tempat) dengan nama akun penyimpanan Anda. Ganti mykey dengan kunci Anda dari langkah sebelumnya.

   "DefaultEndpointsProtocol=https;BlobEndpoint=https://mystorageaccount.blob.core.windows.net;AccountName=mystorageaccount;AccountKey=mykey"
   

   String koneksi ini diperlukan dalam langkah untuk membuat titik akhir.

3. Buat titik akhir Azure Storage Anda dengan string koneksi yang Anda buat. EndpointType harus memiliki nilai azurestorage. Untuk semua parameter lainnya, gunakan nilai untuk skenario Anda. Untuk EndpointName, gunakan nilai unik.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType azurestorage -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "my connection string"
   

4. Saat Anda dimintai nama kontainer, masukkan nama kontainer Anda, lalu pilih Enter untuk membuat titik akhir.

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, antrean dan topik Azure Service Bus, 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.