Criar um hub IoT com a CLI do Azure
Este artigo mostra-lhe como criar um hub IoT com a CLI do Azure.
Pré-requisitos
Utilize o ambiente bash no Azure Cloud Shell. Para obter mais informações, veja Início Rápido do Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, veja Como executar a CLI do Azure num contentor do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de início de sessão, veja Iniciar sessão com a CLI do Azure.
Quando lhe for pedido, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
Quando cria um hub IoT, tem de criá-lo num grupo de recursos. Utilize um grupo de recursos existente ou execute o 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 na localização E.U.A. Oeste. Pode ver uma lista de localizações disponíveis ao executar este comando:
az account list-locations -o table
Criar um hub IoT
Utilize 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 grupo de recursos, com um nome globalmente exclusivo para o seu hub IoT:
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
Importante
Uma vez que o hub IoT será publicamente detetável como um ponto final DNS, certifique-se de que evita introduzir informações confidenciais ou pessoais quando lhe der um nome.
O comando anterior cria um hub IoT no escalão de preço S1 para o qual é faturado. Para obter mais informações, veja preços de Hub IoT do Azure.
Para obter mais informações sobre Hub IoT do Azure comandos, consulte o az iot hub artigo de referência.
Atualizar o hub IoT
Pode alterar as definições de um hub IoT existente depois de este ser criado. Eis algumas propriedades que pode definir para um hub IoT:
Preços e dimensionamento: migre para um escalão diferente ou defina o número de unidades de Hub IoT.
Filtro IP: especifique um intervalo de endereços IP que serão aceites ou rejeitados pelo hub IoT.
Propriedades: uma lista de propriedades que pode copiar e utilizar noutro local, como o ID do recurso, o grupo de recursos, a localização, etc.
Para obter uma lista completa das opções para atualizar um hub IoT, veja a página az iot hub update commands reference (Referência dos comandos de atualização do hub iot ).
Registar um novo dispositivo no hub IoT
Nesta secção, vai criar uma identidade de dispositivo no registo de identidade no seu hub IoT. Um dispositivo não consegue ligar-se a um hub, a menos que tenha uma entrada no registo de identidade. Para obter mais informações, veja Compreender o registo de identidades no seu hub IoT. Esta identidade do dispositivo está IoT Edge ativada.
Execute o seguinte comando para criar uma identidade de dispositivo. Utilize o nome do hub IoT e crie um novo nome de ID do dispositivo em vez de {iothub_name} e {device_id}. Este comando cria uma identidade de dispositivo com autorização predefinida (chave privada partilhada).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
O resultado é uma impressão JSON que inclui as suas chaves e outras informações.
Em alternativa, existem várias opções para registar um dispositivo através de diferentes tipos de autorização. Para explorar as opções, veja Exemplos na página de referência az iot hub device-identity .
Remover um hub IoT
Existem vários comandos para eliminar um recurso individual, como um hub IoT.
Para eliminar um hub IoT, execute o seguinte comando:
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Passos seguintes
Saiba mais sobre os comandos disponíveis na extensão do Microsoft Azure IoT para a CLI do Azure: