Criar e gerenciar hubs de Internet das Coisas do Azure

• Acesso ao portal do Azure.

• A CLI do Azure instalada em seu computador de desenvolvimento. Se você não tiver a CLI do Azure, siga as etapas para instalar a CLI do Azure.

• Um grupo de recursos em sua assinatura do Azure. Se você quiser criar um novo grupo de recursos, use o comando az group create:

  az group create --name <RESOURCE_GROUP_NAME> --location <REGION>
  

• Azure PowerShell instalado em seu computador de desenvolvimento. Se você não tiver o Azure PowerShell, siga as etapas para instalar o Azure PowerShell.

• Um grupo de recursos em sua assinatura do Azure. Se você quiser criar um novo grupo de recursos, use o comando New-AzResourceGroup:

  New-AzResourceGroup -Name <RESOURCE_GROUP_NAME> -Location "<REGION>"
  

Esta seção descreve como criar um hub IoT usando o portal do Azure.

1. Entre no portal do Azure.

2. Na página inicial do Azure, selecione o botão + Criar um recurso.

3. No menu Categorias, escolha Internet das Coisas e, em seguida, selecione Hub IoT.

4. Na guia Básico, preencha os campos da seguinte maneira:

   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.

   Propriedade	Valor
   Assinatura	Selecione a assinatura a ser usada para o hub.
   Grupo de recursos	Selecione um grupo de recursos ou crie um novo. Para criar um novo, selecione Criar novo e preencha o nome que deseja usar.
   Nome do Hub IoT	Digite um nome para o seu hub. Esse nome deve ser globalmente exclusivo e ter um comprimento entre 3 e 50 caracteres alfanuméricos. Ele também pode incluir o caractere de traço ('-').
   Região	Selecione a região mais próxima onde você deseja que o hub esteja localizado. Alguns recursos, como os Fluxos de dispositivo do Hub IoT, estão disponíveis apenas em regiões específicas. Para esses recursos limitados, você deve selecionar uma das regiões com suporte.
   Camada	Selecione a camada que quer usar para o hub. A seleção de camada depende de quantos recursos você deseja e de quantas mensagens você enviará por dia usando a solução. A camada gratuita destina-se a testes e avaliação. A camada gratuita permite que 500 dispositivos sejam conectados ao hub e até 8 mil mensagens por dia. Cada assinatura do Azure pode criar um hub IoT na Camada gratuita. Para comparar os recursos disponíveis para cada camada, selecione Comparar camadas. Para mais informações, confira Escolher a camada certa do Hub IoT para sua solução.
   Limite diário de mensagens	Selecione a cota diária máxima de mensagens para o hub. As opções disponíveis dependem da camada selecionada para o hub. Para ver as opções de mensagens e preços disponíveis, selecione Ver todas as opções e selecione a opção que melhor corresponde às necessidades do hub. Para obter mais informações, confira Cotas e limitação do Hub IoT.

   

   Observação

   Os preços mostrados são apenas para exemplificar.

5. Selecione Avançar: Rede para continuar criando o hub.

6. Na guia Rede, preencha os campos da seguinte maneira:

   Propriedade	Valor
   Configuração de conectividade	Escolha os pontos de extremidade que podem ser usados pelos dispositivos na conexão com o Hub IoT. Aceite a configuração padrão, Acesso público, para esse exemplo. Você pode alterar essa configuração depois que o hub IoT for criado. Para obter mais informações, confira Gerenciar o acesso à rede pública para o hub IoT.
   Versão mínima do TLS	Selecione a versão do TLS mínima para ter suporte no hub IoT. Após a criação do hub IoT, esse valor não poderá ser alterado. Aceite a configuração padrão, 1.0, para esse exemplo.

   

7. Selecione Avançar: Gerenciamento para continuar criando o hub.

8. Na guia Gerenciamento, aceite as configurações padrão. Se desejar, você poderá modificar qualquer um dos seguintes campos:

   Propriedade	Valor
   Modelo de permissão	Parte do controle de acesso baseado em função, essa propriedade decide como você gerencia o acesso ao hub IoT. Permitir políticas de acesso compartilhado ou escolher apenas controle de acesso baseado em função. Para obter mais informações, consulte Controlar o acesso ao Hub IoT do Azure usando o Microsoft Entra ID.
   Atribua-me	Talvez seja necessário acessar as APIs de dados do Hub IoT para gerenciar elementos em uma instância. Se você tiver acesso a atribuições de função, selecione Função de colaborador de dados do Hub IoT para conceder a si mesmo(a) acesso total às APIs de dados. Para adicionar funções do Azure, você precisa ter permissões Microsoft.Authorization/roleAssignments/write, como Administrador de Acesso do Usuário ou Proprietário.
   Partições de dispositivo para nuvem	Essa propriedade está relacionada a mensagens de dispositivo para nuvem para o número de leitores simultâneos das mensagens. A maioria dos hubs IoT precisa apenas de quatro partições.

   

9. Selecione Avançar: complementos para avançar para a próxima tela.

10. Na guia Complementos, aceite as configurações padrão. Se desejar, você poderá modificar qualquer um dos seguintes campos:

    Propriedade	Valor
    Habilitar a Atualização de Dispositivo para Hub IoT	Ative a Atualização de Dispositivo para Hub IoT para habilitar atualizações over-the-air em seus dispositivos. Se você selecionar essa opção, será solicitado a fornecer informações para provisionar uma conta e instância da Atualização de Dispositivo para Hub IoT. Para obter mais informações, confira O que é a Atualização de Dispositivo para Hub IoT.
    Habilitar o Defender para IoT	Ative o Defender para IoT para adicionar uma camada extra de proteção à IoT e aos seus dispositivos. Ela não está disponível para hubs na camada gratuita. Saiba mais sobre as recomendações de segurança para o Hub IoT no Defender para IoT.

    

    Observação

    Os preços mostrados são apenas para exemplificar.

11. Selecione Avançar: Marcas para avançar para a próxima tela.

    Marcas são pares nome/valor. Você pode atribuir a mesma marca a vários recursos e grupos de recursos para categorizá-los e consolidar a cobrança. Neste documento, você não adicionará nenhuma marca. Para obter mais informações, veja Usar marcas para organizar os recursos do Azure.

    

12. Selecione Avançar: Analisar + criar para examinar suas escolhas.

13. Selecione Criar para iniciar a implantação do novo hub. Sua implantação fica em andamento por alguns minutos enquanto o hub é criado. Depois de a implantação ser concluída, selecione Acessar o recurso para abrir o novo hub.

Use o comando az iot hub create para criar um hub IoT em seu grupo de recursos, usando um nome global exclusivo para o hub IoT. Por exemplo:

az iot hub create --name <NEW_NAME_FOR_YOUR_IOT_HUB> --resource-group <RESOURCE_GROUP_NAME> --sku S1

O comando anterior cria um hub IoT no tipo de preço S1. Para saber mais, confira Preço do Hub IoT do Azure.

Use o comando New-AzIotHub para criar um hub IoT em seu grupo de recursos. O nome do Hub IoT deve ser globalmente exclusivo. Por exemplo:

New-AzIotHub `
    -ResourceGroupName <RESOURCE_GROUP_NAME> `
    -Name <NEW_NAME_FOR_YOUR_IOT_HUB> `
    -SkuName S1 -Units 1 `
    -Location "<REGION>"

O comando anterior cria um hub IoT no tipo de preço S1. Para saber mais, confira Preço do Hub IoT do Azure.

1. No portal do Azure, selecione Grupos de recursos. Selecione o grupo de recursos em que o Hub está localizado e, em seguida, selecione o seu hub na lista de recursos.

2. No painel do lado esquerdo do hub IoT, selecione Políticas de acesso compartilhado.

3. Na lista de políticas, selecione a política de serviço.

4. Copie a Cadeia de conexão primária e salve o valor.

Use o comando az iot hub connection-string show para obter uma cadeia de conexão para o hub IoT que concede as permissões de política de serviço:

az iot hub connection-string show --hub-name <YOUR_IOT_HUB_NAME> --policy-name service

A cadeia de conexão do serviço deve ser semelhante ao seguinte exemplo:

"HostName=<IOT_HUB_NAME>.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey=<SHARED_ACCESS_KEY>"

Use o comando Get-AzIotHubConnectionString para obter uma cadeia de conexão para o hub IoT que concede as permissões de política de serviço.

Get-AzIotHubConnectionString -ResourceGroupName "<YOUR_RESOURCE_GROUP>" -Name "<YOUR_IOT_HUB_NAME>" -KeyName "service"

A cadeia de conexão do serviço deve ser semelhante ao seguinte exemplo:

"HostName=<IOT_HUB_NAME>.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey=<SHARED_ACCESS_KEY>"

Para excluir um hub IoT, abra o hub IoT no portal do Azure e escolha Excluir.

Para excluir um hub IoT, execute o comando az iot hub delete:

az iot hub delete --name <IOT_HUB_NAME> --resource-group <RESOURCE_GROUP_NAME>

É possível excluir o hub IoT usando o comando Remove-AzIotHub.

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub