Rychlý start: Nastavení služby IoT Hub Device Provisioning pomocí Azure CLI

Azure CLI slouží k vytváření a správě prostředků Azure z příkazového řádku nebo ve skriptech. Tento rychlý start podrobně popisuje vytvoření centra IoT a instance služby IoT Hub Device Provisioning pomocí Azure CLI a propojení těchto dvou služeb.

Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

Důležité

Centrum IoT i služba zřizování, které vytvoříte v tomto rychlém startu, jsou veřejně zjistitelné jako koncové body DNS. Pokud se rozhodnete změnit názvy používané pro tyto prostředky, nezapomeňte se vyhnout jakýmkoli citlivým informacím.

Požadavky

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

  

• Pokud chcete spouštět referenční příkazy CLI lokálně, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Pro více informací, viz Jak spustit Azure CLI v Docker kontejneru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Chcete-li dokončit proces ověřování, postupujte podle kroků zobrazených ve vašem terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

  • Když budete vyzváni, nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

  • Spusťte az version, abyste zjistili verzi a závislé knihovny, které jsou nainstalovány. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Vytvoření skupiny zdrojů

Vytvořte skupinu prostředků s využitím příkazu az group create. Skupina prostředků Azure je logický kontejner, do kterého se nasazují a spravují prostředky Azure.

Následující příklad vytvoří skupinu prostředků my-sample-resource-group v umístění westus.

az group create --name my-sample-resource-group --location westus

Návod

Příklad vytvoří skupinu prostředků na západě USA. Seznam dostupných umístění můžete zobrazit spuštěním příkazu az account list-locations -o table.

Vytvořte IoT hub

Vytvořte centrum IoT pomocí příkazu az iot hub create .

Následující příklad vytvoří centrum IoT s názvem my-sample-hub v umístění westus . Název centra IoT musí být globálně jedinečný v Azure, takže buď přidejte k ukázkovému názvu jedinečnou předponu nebo příponu, nebo úplně zvolte nový název. Ujistěte se, že název odpovídá správným konvencím vytváření názvů pro centrum IoT: měl by mít délku 3–50 znaků a může obsahovat jenom velké nebo malé alfanumerické znaky nebo spojovníky (-).

az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus

Vytvoření instance služby Device Provisioning

Pomocí příkazu az iot dps create vytvořte instanci služby Device Provisioning.

Následující příklad vytvoří instanci služby Device Provisioning s názvem my-sample-dps v umístění westus . Musíte také zvolit globálně jedinečný název pro vlastní instanci. Ujistěte se, že se řídí správnými konvencemi vytváření názvů pro službu IoT Hub Device Provisioning: měla by mít délku 3 až 64 znaků a může obsahovat pouze velké nebo malé alfanumerické znaky nebo spojovníky (-).

az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus

Návod

Příklad vytvoří provádění služby v západním USA. Seznam dostupných umístění můžete zobrazit spuštěním příkazu az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table nebo na stránce stavu Azure a vyhledáním služby Device Provisioning. V příkazech lze umístění zadat buď v jednom slově, nebo ve víceslovné podobě; například: westus, West US, WEST US atd. Hodnota nerozlišuje malá a velká písmena. Pokud k určení umístění použijete víceslovný formát, uzavřete hodnotu do uvozovek; například --location "West US".

Kvůli odolnosti a spolehlivosti doporučujeme nasazení do jedné z oblastí, které podporují Zóny dostupnosti.

Získejte řetězec připojení pro Centrum IoT

Abyste ho mohli propojit se službou Device Provisioning, potřebujete připojovací řetězec centra IoT. Pomocí příkazu az iot hub connection-string show získejte připojovací řetězec a pomocí jeho výstupu nastavte proměnnou použitou později při propojení těchto dvou prostředků.

Následující příklad nastaví proměnnou hubConnectionString na hodnotu připojovacího řetězce pro primární klíč zásad iothubowner centra ( --policy-name parametr lze použít k určení jiné zásady). Vyměňte my-sample-hub pro jedinečný název centra IoT, který jste zvolili dříve. Příkaz pomocí dotazu a výstupních možností Azure CLI extrahuje připojovací řetězec z výstupu příkazu.

hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)

Připojovací řetězec můžete zobrazit pomocí echo příkazu.

echo $hubConnectionString

Poznámka:

Tyto dva příkazy jsou platné pro hostitele spuštěného v prostředí Bash.

Pokud používáte místní prostředí Windows/CMD nebo hostitele PowerShellu, upravte příkazy tak, aby používaly správnou syntaxi pro dané prostředí.

Pokud používáte Azure Cloud Shell, zkontrolujte, jestli se v rozevíracím seznamu prostředí na levé straně okna prostředí zobrazuje Bash.

Propojení centra IoT a služby zřizování

Propojte IoT hub se svou službou zřizování příkazem az iot dps linked-hub create.

Následující příklad propojuje centrum IoT s názvem my-sample-hub v umístění westus a službu Device Provisioning s názvem my-sample-dps. Vyměňte tyto názvy za jedinečné názvy IoT Hubu a služby Device Provisioning, které jste zvolili dříve. Příkaz používá připojovací řetězec pro vaše centrum IoT, které bylo uloženo v proměnné hubConnectionString v předchozím kroku.

az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus

Dokončení příkazu může trvat několik minut.

Ověřte službu zřizování

Získejte podrobnosti o vaší poskytovací službě pomocí příkazu az iot dps show.

Následující příklad získá podrobnosti o službě zřizování s názvem my-sample-dps. Nahraďte tento název za vlastní název služby Device Provisioning Service.

az iot dps show --name my-sample-dps

Propojené centrum IoT se zobrazuje v kolekci properties.iotHubs .

Vyčistěte zdroje

Další rychlé návody v této kolekci vycházejí z tohoto rychlého návodu. Pokud plánujete pokračovat v práci s následnými rychlými starty nebo kurzy, neodstraňujte prostředky vytvořené v tomto rychlém startu. Pokud pokračovat nechcete, můžete pomocí následujících příkazů odstranit službu zřizování, centrum IoT nebo skupinu prostředků a všechny její prostředky. Názvy prostředků obsažených v následujících příkazech nahraďte názvy vlastních prostředků.

Pokud chcete odstranit službu zřizování, spusťte příkaz az iot dps delete :

az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group

Pokud chcete odstranit centrum IoT, spusťte příkaz az iot hub delete :

az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group

Pokud chcete odstranit skupinu prostředků a všechny její prostředky, spusťte příkaz az group delete :

az group delete --name my-sample-resource-group

Další kroky

V tomto rychlém startu jste nasadili centrum IoT a instanci služby Device Provisioning a propojili dva prostředky. Pokud chcete zjistit, jak pomocí tohoto nastavení zřídit zařízení, pokračujte rychlým startem pro vytvoření zařízení.

Rychlý start: Zřízení simulovaného zařízení symetrického klíče