Mulai Cepat - IoT Hub Device Provisioning Service menggunakan Azure CLI
Azure CLI digunakan untuk membuat dan mengelola sumber daya Azure dari baris perintah atau dalam skrip. Detail mulai cepat ini menggunakan Azure CLI untuk membuat hub IoT dan instans IoT Hub Device Provisioning Service, dan untuk menautkan dua layanan bersama-sama.
Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.
Penting
Hub IoT dan layanan provisi yang Anda buat dalam quickstart ini akan dapat ditemukan secara publik sebagai titik akhir DNS. Pastikan untuk menghindari informasi sensitif jika Anda memutuskan untuk mengubah nama yang digunakan untuk sumber daya ini.
Prasyarat
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.
Buat grup sumber daya
Buat grup sumber daya dengan perintah az group create. Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure disebarkan dan dikelola.
Contoh berikut ini menampilkan cara membuat grup sumber daya bernama my-sample-resource-group di lokasi westus.
az group create --name my-sample-resource-group --location westus
Tip
Contohnya membuat grup sumber daya di lokasi AS Barat. Anda bisa menampilkan daftar lokasi yang tersedia dengan menjalankan az account list-locations -o table perintah.
Membuat IoT Hub
Buat IoT Hub menggunakan perintah az iot hub create.
Contoh berikut membuat hub IoT bernama my-sample-hub di lokasi westus. Nama hub IoT harus unik secara global di Azure, jadi tambahkan awalan atau akhiran unik ke nama contoh atau pilih nama baru sama sekali. Pastikan nama Anda mengikuti konvensi penamaan yang tepat untuk hub IoT: panjangnya harus 3-50 karakter, dan hanya dapat berisi karakter alfanumerik huruf besar atau kecil atau tanda hubung ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Membuat instans Device Provisioning Service
Buat instans Device Provisioning Service dengan perintah az iot dps create .
Contoh berikut membuat instans Device Provisioning Service bernama my-sample-dps di lokasi westus . Anda juga harus memilih nama unik global untuk instans Anda sendiri. Pastikan mengikuti konvensi penamaan yang tepat untuk IoT Hub Device Provisioning Service: panjangnya harus 3-64 karakter dan hanya dapat berisi karakter alfanumerik huruf besar atau kecil atau tanda hubung ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Tip
Contohnya membuat layanan provisi di lokasi AS Barat. Anda dapat melihat daftar lokasi yang tersedia dengan menjalankan perintah az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table atau dengan membuka laman Status Azure dan mencari "Device Provisioning Service". Dalam perintah, lokasi dapat ditentukan baik dalam format satu kata atau multi-kata; misal: westus, US Barat, US BARAT, dll. Nilainya tidak peka huruf besar/kecil. Jika Anda menggunakan format multi-kata untuk menentukan lokasi, sertakan nilai dalam tanda kutip; misalnya, --location "West US".
Untuk ketahanan dan keandalan, sebaiknya sebarkan ke salah satu wilayah yang mendukung Zona Ketersediaan.
Dapatkan string koneksi untuk hub IoT
Anda memerlukan string koneksi hub IoT Anda untuk menautkannya dengan Device Provisioning Service. Gunakan perintah az iot hub connection-string show untuk mendapatkan string koneksi dan menggunakan outputnya untuk mengatur variabel yang digunakan nanti, saat Anda menautkan dua sumber daya.
Contoh berikut menetapkan variabel hubConnectionString ke nilai string koneksi untuk kunci utama kebijakan iothubowner hub --policy-name (parameter dapat digunakan untuk menentukan kebijakan yang berbeda). Perdagangkan my-sample-hub untuk nama hub IoT unik yang Anda pilih sebelumnya. Perintah ini menggunakan kueri Azure CLI dan opsi output untuk mengekstrak string koneksi dari output perintah.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Anda dapat menggunakan echo perintah untuk melihat string koneksi.
echo $hubConnectionString
Catatan
Kedua perintah ini berlaku untuk host yang berjalan di bawah Bash.
Jika Anda menggunakan shell Windows/CMD lokal atau host PowerShell, ubah perintah untuk menggunakan sintaks yang benar untuk lingkungan tersebut.
Jika Anda menggunakan Azure Cloud Shell, periksa apakah lingkungan turun bawah di sisi kiri jendela shell mengatakan Bash.
Menautkan hub IoT dan layanan provisi
Tautkan hub IoT dan layanan provisi Anda dengan perintah buat hub tertaut az iot dps.
Contoh berikut menautkan hub IoT bernama my-sample-hubdi lokasi westus dan Device Provisioning Service bernama my-sample-dps. Perdagangkan nama-nama ini untuk hub IoT unik dan nama Device Provisioning Service yang Anda pilih sebelumnya. Perintah ini menggunakan string koneksi untuk hub IoT Anda yang disimpan dalam variabel hubConnectionString pada langkah sebelumnya.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Perintah ini mungkin perlu waktu beberapa menit untuk diselesaikan.
Memverifikasi layanan provisi
Dapatkan detail layanan provisi Anda dengan perintah pertunjukan az iot dps.
Contoh berikut mendapatkan detail layanan provisi bernama my-sample-dps. Ganti nama ini dengan nama Device Provisioning Service Anda sendiri.
az iot dps show --name my-sample-dps
Hub IoT yang ditautkan ditampilkan dalam koleksi properties.iotHubs.
Membersihkan sumber daya
Panduan mulai cepat yang lain dalam koleksi ini dibangun berdasarkan panduan mulai cepat ini. Jika Anda berencana untuk terus bekerja dengan mulai cepat berikutnya atau dengan tutorial, jangan bersihkan sumber daya yang dibuat dalam mulai cepat ini. Jika Anda tidak berencana untuk melanjutkan, Anda dapat menggunakan perintah berikut untuk menghapus layanan provisi, hub IoT, atau grup sumber daya dan semua sumber dayanya. Ganti nama sumber daya yang disertakan dalam perintah berikut dengan nama sumber daya Anda sendiri.
Untuk menghapus layanan provisi, jalankan perintah hapus az iot dps:
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Untuk menghapus IoT hub, jalankan perintah hapus az iot dps:
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Untuk menghapus grup sumber daya dan semua sumber dayanya, jalankan perintah hapus grup az:
az group delete --name my-sample-resource-group
Langkah berikutnya
Dalam mulai cepat ini, Anda menyebarkan hub IoT dan instans Device Provisioning Service, dan menautkan dua sumber daya. Untuk mempelajari cara menggunakan penyetelan ini untuk provisikan perangkat, lanjutkan ke mulai cepat untuk membuat perangkat.