Criar um Hub IoT usando a CLI do Azure

Este artigo mostra como criar um Hub IoT usando a CLI do Azure.

Pré-requisitos

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: