Cara menautkan dan mengelola hub IoT

Di portal Azure, Anda dapat menautkan hub IoT baik dari menu kiri instans DPS Anda atau dari pendaftaran saat membuat atau memperbarui pendaftaran. Dalam kedua kasus, hub IoT dilingkupkan ke instans DPS (bukan hanya pendaftaran).

Untuk menautkan hub IoT ke instans DPS Anda di portal Azure:

1. Di menu sebelah kiri instans DPS Anda, pilih Hub IoT tertaut.

2. Di bagian atas halaman, pilih + Tambahkan.

3. Pada halaman Tambahkan tautan ke hub IoT, pilih langganan yang berisi hub IoT lalu pilih nama hub IoT dari daftar hub IoT.

4. Setelah Anda memilih hub IoT, pilih kebijakan akses yang akan digunakan DPS untuk menyambungkan ke hub IoT. Daftar Kebijakan Akses memperlihatkan semua kebijakan akses bersama yang ditentukan pada IoT Hub yang dipilih yang memiliki izin RegistriWrite dan ServiceConnect yang ditentukan. Defaultnya adalah kebijakan iothubowner . Pilih kebijakan yang ingin Anda gunakan.

5. Pilih Simpan.

Gunakan perintah az iot dps linked-hub create Azure CLI untuk menautkan hub IoT ke instans DPS Anda.

Misalnya, perintah berikut menautkan hub IoT bernama MyExampleHub menggunakan string koneksi untuk kebijakan akses bersama iothubowner-nya. Perintah ini meninggalkan bobot Alokasi dan Menerapkan pengaturan kebijakan alokasi pada defaultnya, tetapi Anda dapat menentukan nilai untuk pengaturan ini jika Anda mau.

az iot dps linked-hub create --dps-name MyExampleDps --resource-group MyResourceGroup --connection-string "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=XNBhoasdfhqRlgGnasdfhivtshcwh4bJwe7c0RIGuWsirW0=" --location westus

Dalam portal Azure, Anda dapat memperbarui bobot Alokasi dan Menerapkan pengaturan kebijakan alokasi.

Untuk memperbarui pengaturan hub IoT tertaut menggunakan portal Azure:

1. Di menu sebelah kiri instans DPS Anda, pilih Hub IoT tertaut, lalu pilih hub IoT dari daftar.

2. Pada halaman Detail hub IoT Tertaut:

   

   • Gunakan slider atau kotak teks Bobot alokasi untuk memilih bobot antara satu dan 1000. Defaultnya adalah satu.

   • Atur tombol Terapkan kebijakan alokasi untuk menentukan apakah hub IoT yang ditautkan harus disertakan dalam alokasi.

3. Simpan pengaturan Anda.

Dengan Azure CLI, Anda dapat memperbarui bobot Alokasi, Menerapkan kebijakan alokasi, dan pengaturan String koneksi.

Gunakan perintah az iot dps linked-hub update untuk memperbarui bobot alokasi atau menerapkan pengaturan kebijakan alokasi. Misalnya, perintah berikut menetapkan bobot alokasi dan menerapkan kebijakan alokasi untuk hub IoT tertaut:

az iot dps linked-hub update --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub --allocation-weight 2 --apply-allocation-policy true

Gunakan perintah az iot dps update untuk memperbarui string koneksi untuk hub IoT tertaut. Anda dapat menggunakan --set parameter bersama dengan string koneksi untuk kebijakan akses bersama hub IoT yang ingin Anda gunakan. Untuk detailnya, lihat Memperbarui kunci untuk hub IoT tertaut.

Untuk menghapus hub IoT tertaut dari instans DPS Anda di portal Azure:

1. Di menu sebelah kiri instans DPS Anda, pilih Hub IoT tertaut.

2. Dari daftar hub IoT, pilih kotak centang di samping hub IoT atau hub IoT yang ingin Anda hapus. Lalu pilih Hapus di bagian atas halaman dan konfirmasikan pilihan Anda saat diminta.

Gunakan perintah az iot dps linked-hub delete untuk menghapus hub IoT tertaut dari instans DPS. Misalnya, perintah berikut menghapus hub IoT bernama MyExampleHub:

az iot dps linked-hub delete --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub

Anda tidak dapat memperbarui pengaturan string koneksi untuk IoT Hub tertaut saat menggunakan portal Azure. Sebagai gantinya, Anda perlu menghapus hub IoT yang ditautkan dari instans DPS Anda lalu membacanya.

Untuk memperbarui kunci konten untuk hub IoT tertaut di portal Azure:

1. Di menu sebelah kiri instans DPS Anda di portal Azure, pilih hub IoT yang ingin Anda perbarui satu atau beberapa kuncinya.

2. Pada halaman Detail hub IoT tertaut, catat nilai untuk Bobot alokasi dan Terapkan kebijakan alokasi. Anda memerlukan nilai-nilai ini saat menautkan kembali hub IoT ke instans DPS Anda nanti. Lalu, pilih Kelola Sumber Daya untuk masuk ke hub IoT.

3. Di menu sebelah kiri hub IoT, di bawah Pengaturan keamanan, pilih Kebijakan akses bersama.

4. Pada Kebijakan akses bersama, di bawah Kelola kebijakan akses bersama, pilih kebijakan yang digunakan instans DPS Anda untuk menyambungkan ke hub IoT yang ditautkan.

5. Di bagian atas halaman, pilih Regenerasi kunci primer, Regenerasi kunci sekunder, atau Tukar kunci, dan konfirmasikan pilihan Anda saat diminta.

6. Navigasikan kembali ke instans DPS Anda.

7. Ikuti langkah-langkah di bagian Hapus hub IoT tertaut untuk menghapus hub IoT dari instans DPS Anda.

8. Ikuti langkah-langkah di bagian Tambahkan hub IoT tertaut untuk menautkan ulang hub IoT ke instans DPS Anda dengan string koneksi baru untuk kebijakan tersebut.

9. Jika Anda perlu memulihkan bobot alokasi dan menerapkan pengaturan kebijakan alokasi, ikuti langkah-langkah di bagian Memperbarui hub IoT tertaut menggunakan nilai yang Anda simpan di langkah 2.

Untuk memperbarui kunci konten untuk hub IoT tertaut dengan Azure CLS:

1. Gunakan perintah az iot hub policy renew-key untuk menukar atau meregenerasi kunci konten untuk kebijakan akses bersama di hub IoT. Misalnya, perintah berikut memperbarui kunci utama untuk kebijakan akses bersama iothubowner di hub IoT:

   az iot hub policy renew-key --hub-name MyExampleHub --name owner --rk primary
   

2. Gunakan perintah az iot hub connection-string show untuk mendapatkan string koneksi baru untuk kebijakan akses bersama. Misalnya, perintah berikut mendapatkan string koneksi utama untuk kebijakan akses bersama iothubowner yang kunci utamanya diregenerasi di perintah sebelumnya:

   az iot hub connection-string show --hub-name MyExampleHub --policy-name owner --key-type primary
   

3. Gunakan perintah az iot dps linked-hub list untuk menemukan posisi hub IoT dalam kumpulan hub IoT tertaut untuk instans DPS Anda. Misalnya, perintah berikut mendapatkan string koneksi utama untuk kebijakan akses bersama pemilik yang kunci utamanya diregenerasi di perintah sebelumnya:

   az iot dps linked-hub list --dps-name MyExampleDps
   

   Output menunjukkan posisi hub IoT tertaut yang ingin Anda perbarui string koneksi dalam tabel hub IoT tertaut yang dikelola oleh instans DPS Anda. Dalam hal ini, ini adalah hub IoT pertama dalam daftar, MyExampleHub.

   [
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "MyExampleHub.azure-devices.net"
   },
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "NyExampleHub-2.azure-devices.net"
   }
   ]
   

4. Gunakan perintah az iot dps update untuk memperbarui string koneksi untuk hub IoT yang ditautkan. Anda menggunakan --set parameter dan posisi hub IoT yang ditautkan dalam properties.iotHubs[] tabel untuk menargetkan hub IoT. Misalnya, perintah berikut memperbarui string koneksi untuk MyExampleHub yang dikembalikan terlebih dahulu di perintah sebelumnya:

   az iot dps update --name MyExampleDps --set properties.iotHubs[0].connectionString="HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=NewTokenValue"