Criar um Hub IoT usando a CLI do Azure
Este artigo mostra como criar um Hub IoT usando a CLI do Azure.
Pré-requisitos
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.
Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com 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 extensões com a CLI do Azure.
Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.
Quando cria um Hub IoT, você deve criá-lo em um grupo de recursos. Use um grupo de recursos existente ou execute o seguinte comando para criar um grupo de recursos:
az group create --name {your resource group name} --location westus
Dica
O exemplo anterior cria o grupo de recursos localizado no Oeste dos EUA. Você pode exibir uma lista dos locais disponíveis executando o comando:
az account list-locations -o table
Crie um hub IoT
Use a CLI do Azure para criar um grupo de recursos e, em seguida, adicione um Hub IoT.
Execute o seguinte comando para criar um Hub IoT no seu grupo de recursos, usando um nome globalmente exclusivo para o Hub IoT:
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
Importante
Como o Hub IoT será publicamente detectável como um ponto de extremidade DNS, evite inserir informações de identificação pessoal ou confidenciais ao nomeá-lo.
O comando anterior cria um Hub IoT com tipo de preço S1, pelo qual você será cobrado. Para saber mais, confira Preço do Hub IoT do Azure.
Para obter mais informações sobre comandos Hub IoT do Azure, consulte o artigo de referência az iot hub.
Atualizar o hub IoT
Você poderá alterar as configurações de um Hub IoT existente depois que ele for criado. Aqui estão algumas propriedades que você pode definir para um hub IoT:
Preço e escala: migre para uma camada diferente ou definir o número de unidades do Hub IoT.
Filtro de IP: especifique um intervalo de endereços IP que serão aceitos ou rejeitados pelo Hub IoT.
Propriedades: uma lista de propriedades que você pode copiar e usar em outros lugares, como ID de recurso, grupo de recursos, local e assim por diante.
Para obter uma lista completa de opções para atualizar um hub IoT, consulte a página de referência de comandos de atualização do hub az iot.
Registrar um novo dispositivo no hub IoT
Nesta seção, você cria uma identidade de dispositivo no registro de identidade no hub IoT. Um dispositivo não pode se conectar ao hub, a menos que ele tenha uma entrada no registro de identidade. Para obter mais informações, consulte Entender o registro de identidade no Hub IoT. Essa identidade do dispositivo está IoT Edge habilitada.
Execute o seguinte comando para criar uma identidade do dispositivo. Use o nome do hub IoT e crie um novo nome de ID do dispositivo no lugar de {iothub_name} e {device_id}. Esse comando cria uma identidade de dispositivo com autorização padrão (chave privada compartilhada).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
O resultado é uma impressão JSON que inclui suas chaves e outras informações.
Como alternativa, há várias opções para registrar um dispositivo usando diferentes tipos de autorização. Para explorar as opções, consulte Exemplos na página de referência de identidade de dispositivo do hub az iot .
Remover um hub IoT
Há vários comandos para excluir um recurso individual, como um hub IoT.
Para excluir um Hub IoT, execute o seguinte comando:
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Próximas etapas
Saiba mais sobre os comandos disponíveis na extensão de IoT do Microsoft Azure para CLI do Azure: