Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A CLI do Azure é usada para criar e gerenciar recursos do Azure da linha de comando ou em scripts. Este início rápido detalha o uso da CLI do Azure para criar um hub IoT e uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT e vincular os dois serviços juntos.
Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.
Importante
O hub IoT e o serviço de provisionamento criados neste início rápido são detectáveis publicamente como pontos de extremidade DNS. Evite informações confidenciais se decidir alterar os nomes usados para esses recursos.
Pré-requisitos
Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
Criar um grupo de recursos
Crie um grupo de recursos com o comando az group create. Um grupo de recursos do Azure é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.
O exemplo a seguir cria um grupo de recursos chamado my-sample-resource-group no local do westus .
az group create --name my-sample-resource-group --location westus
Dica
O exemplo cria o grupo de recursos localizado no Oeste dos EUA. Você pode exibir uma lista de locais disponíveis executando o comando az account list-locations -o table.
Crie um hub IoT
Crie um hub IoT com o comando az iot hub create .
O exemplo a seguir cria um hub IoT chamado my-sample-hub no local do westus . Um nome de hub IoT deve ser globalmente exclusivo no Azure, portanto, adicione um prefixo exclusivo ou sufixo ao nome do exemplo ou escolha um novo nome completamente. Verifique se seu nome segue as convenções de nomenclatura adequadas para um hub IoT: ele deve ter de 3 a 50 caracteres de comprimento e pode conter apenas caracteres alfanuméricos de maiúsculas ou minúsculas ou hifens ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Criar uma instância do Serviço de Provisionamento de Dispositivos
Crie uma instância do Serviço de Provisionamento de Dispositivos com o comando az iot dps create .
O exemplo a seguir cria uma instância do Serviço de Provisionamento de Dispositivos chamada my-sample-dps na região westus. Você também deve escolher um nome globalmente exclusivo para sua própria instância. Verifique se ele segue as convenções de nomenclatura adequadas para um Serviço de Provisionamento de Dispositivos do Hub IoT: ele deve ter de 3 a 64 caracteres de comprimento e pode conter apenas caracteres alfanuméricos de maiúsculas ou minúsculas ou hifens ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Dica
O exemplo cria o serviço de provisionamento no local Oeste dos EUA. Você pode exibir uma lista de locais disponíveis executando o comando az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table ou acessando a página Status do Azure e pesquisando "Serviço de Provisionamento de Dispositivos". Em comandos, as localizações podem ser especificadas em formato de uma ou várias palavras; por exemplo: oestedoseua, Oeste dos EUA, OESTE DOS EUA, etc. O valor não diferencia maiúsculas de minúsculas. Se você usar o formato de várias palavras para especificar o local, coloque o valor entre aspas; por exemplo, --location "West US".
Para resiliência e confiabilidade, recomendamos implantar em uma das regiões que dão suporte a Zonas de Disponibilidade.
Obter o string de conexão para o hub IoT
Você precisa da cadeia de conexão do hub IoT para vinculá-la ao Serviço de Provisionamento de Dispositivos. Use o comando az iot hub connection-string show para obter a cadeia de conexão e usar sua saída para definir uma variável usada posteriormente, quando você vincular os dois recursos.
O exemplo a seguir define a variável hubConnectionString como o valor da cadeia de conexão para a chave primária da política iothubowner do hub (o --policy-name parâmetro pode ser usado para especificar uma política diferente). Troque meu hub de exemplo pelo nome exclusivo do hub IoT que você escolheu anteriormente. O comando usa as opções de consulta e saída da CLI do Azure para extrair a cadeia de conexão da saída do comando.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Você pode usar o echo comando para ver a cadeia de conexão.
echo $hubConnectionString
Observação
Esses dois comandos são válidos para um host em execução no Bash.
Se você estiver usando um shell local do Windows/CMD ou um host do PowerShell, modifique os comandos para usar a sintaxe correta para esse ambiente.
Se você estiver usando o Azure Cloud Shell, verifique se a lista suspensa ambiente no lado esquerdo da janela do shell diz Bash.
Vincular o hub IoT e o serviço de provisionamento
Vincule o hub IoT e seu serviço de provisionamento com o comando az iot dps linked-hub create .
O exemplo a seguir vincula um hub IoT chamado my-sample-hub no local do westus e um Serviço de Provisionamento de Dispositivos chamado my-sample-dps. Troque esses nomes pelos nomes exclusivos do Hub IoT e do Serviço de Provisionamento de Dispositivos que você escolheu anteriormente. O comando usa a cadeia de conexão para o hub IoT que foi armazenado na variável hubConnectionString na etapa anterior.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
O comando pode levar alguns minutos para ser concluído.
Verificar o serviço de provisionamento
Obtenha os detalhes do serviço de provisionamento com o comando az iot dps show .
O exemplo a seguir obtém os detalhes de um serviço de provisionamento chamado my-sample-dps. Troque esse nome pelo seu próprio nome do Serviço de Provisionamento de Dispositivos.
az iot dps show --name my-sample-dps
O hub IoT vinculado é mostrado na coleção properties.iotHubs .
Limpar os recursos
Outros inícios rápidos nessa coleção aproveitam esse início rápido. Se você planeja continuar trabalhando com os inícios rápidos subsequentes ou os tutoriais, não limpe os recursos criados neste início rápido. Se você não planeja continuar, pode usar os comandos a seguir para excluir o serviço de provisionamento, o hub IoT ou o grupo de recursos e todos os seus recursos. Substitua os nomes dos recursos incluídos nos comandos a seguir pelos nomes de seus próprios recursos.
Para excluir o serviço de provisionamento, execute o comando az iot dps delete :
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Para excluir o hub IoT, execute o comando az iot hub delete :
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Para excluir um grupo de recursos e todos os seus recursos, execute o comando az group delete :
az group delete --name my-sample-resource-group
Próximas etapas
Neste início rápido, você implantou um hub IoT e uma instância do Serviço de Provisionamento de Dispositivos e vinculou os dois recursos. Para aprender a usar essa configuração a fim de provisionar um dispositivo, prossiga para o Início Rápido de criação de dispositivo.