Configurar pontos de extremidade privados para a conta de Atualização de Dispositivo para Hub IoT.

Não há pré-requisitos para o portal do Azure.

Um ambiente da CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell.

  

• Ou, se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure

  • Entre na CLI do Azure usando o comando az login.

  • 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 solicitado, instale as extensões da CLI do Azure no primeiro uso. Os comandos neste artigo usam a extensão azure-iot. Execute az extension update --name azure-iot para verificar se está usando a versão mais recente da extensão.

1. No portal do Azure, navegue até Centro de Link Privado>Pontos de Extremidade Privados e selecione +Criar.

   

2. Na página Informações Básicas, forneça as informações a seguir para o ponto de extremidade privado:

   • Assinatura: a assinatura do Azure em que você deseja criar o ponto de extremidade privado.
   • Grupo de recursos: um grupo de recursos existente ou novo para o ponto de extremidade privado.
   • Nome: um nome para o ponto de extremidade. Esse valor é usado para gerar automaticamente o nome da interface de rede.
   • Região: uma região do Azure para o ponto de extremidade. O ponto de extremidade privado deve estar na mesma região que a rede virtual, mas pode estar em uma região diferente da conta de Atualização de Dispositivo.

3. Preencha todos os campos obrigatórios na guia Recurso

   • Método de conexão: selecione Conectar-se a um recurso do Azure com a ID do recurso ou o alias.
   • ID do recurso ou alias: insira a ID do recurso da conta de Atualização de Dispositivo. Você pode recuperar a ID do recurso de uma conta de Atualização de Dispositivo no portal do Azure, selecionando o Modo de Exibição JSON na página Visão Geral. Ou você pode recuperá-la usando o comando az iot du account show e consultando o valor da ID: az iot du account show -n <account_name> --query id.
   • Sub-recurso de destino: o valor deve ser DeviceUpdate

   

4. Na página Rede Virtual, selecione a sub-rede e a rede virtual em que você deseja implantar o ponto de extremidade privado.

   • Rede virtual: somente as redes virtuais na assinatura e no local selecionados no momento são listadas na lista suspensa.
   • Sub-rede: selecione uma sub-rede na rede virtual selecionada.

5. Na página DNS, use os valores pré-preenchidos, a menos que você esteja usando seu próprio DNS personalizado.

6. Na página Marcas, crie quaisquer marcas (nomes e valores) que você deseja associar ao recurso de ponto de extremidade privado.

7. Na página Examinar e criar, examine todas as configurações e selecione Criar, para criar o ponto de extremidade privado.

Use o comando az network private-endpoint create para criar um ponto de extremidade privado.

Substitua os espaços reservados a seguir com suas próprias informações:

• RESOURCE_GROUP_NAME: nome do grupo de recursos.
• PRIVATE_ENDPOINT_NAME: nome do ponto de extremidade privado.
• PRIVATE_LINK_CONNECTION_NAME: nome da conexão de serviço do link privado.
• VIRTUAL_NETWORK_NAME: nome de uma rede virtual existente associada à sub-rede.
• SUBNET_NAME: nome ou ID de uma sub-rede existente. Se você usar um nome de sub-rede, também precisará incluir o nome da rede virtual. Se você usar a ID da sub-rede, poderá omitir o parâmetro --vnet-name.
• DEVICE_UPDATE_RESOURCE_ID: você pode recuperar a ID do recurso de uma conta de Atualização de Dispositivo no portal do Azure, selecionando o Modo de Exibição JSON na página Visão Geral. Ou você pode recuperá-la usando o comando az iot du account show e consultando o valor da ID: az iot du account show -n <account_name> --query id.
• LOCAL: nome da região do Azure. O ponto de extremidade privado deve estar na mesma região que a rede virtual, mas pode estar em uma região diferente da conta de Atualização de Dispositivo.

az network private-endpoint create \
    --resource-group <RESOURCE_GROUP_NAME> \
    --name <PRIVATE_ENDPOINT_NAME> \
    --connection-name <PRIVATE_LINK_CONNECTION_NAME> \
    --vnet-name <VIRTUAL_NETWORK_NAME> \
    --subnet <SUBNET_NAME> \
    --private-connection-resource-id "<DEVICE_UPDATE_RESOURCE_ID> \
    --location <LOCATION> \
    --group-id DeviceUpdate
    --request-message "Optional message"
    --manual-request

Você pode excluir um ponto de extremidade privado usando o comando az network private-endpoint delete.

az network private-endpoint delete --resource-group <RESOURCE_GROUP_NAME> --name <PRIVATE_ENDPOINT_NAME>

Examinar uma conexão pendente na conta de Atualização de Dispositivo

1. No portal do Azure, navegue até a conta de Atualização de Dispositivo que você deseja gerenciar.

2. Selecione a guia Rede.

3. Se houver conexões pendentes, será exibida uma lista de conexões com estado de provisionamento Pendente.

   

4. Use a caixa de seleção para marcar a conexão pendente e selecione Aprovar ou Rejeitar.

Examinar uma conexão pendente no Centro de Link Privado

1. No portal do Azure, navegue até Centro de Link Privado>Conexões Pendentes.

2. Use a caixa de seleção para marcar a conexão pendente e selecione Aprovar ou Rejeitar.

   

Use o comando az iot du account private-endpoint-connection set para gerenciar a conexão do ponto de extremidade privado.

Substitua os espaços reservados a seguir com suas próprias informações:

• ACCOUNT_NAME: nome da conta de Atualização de Dispositivo.
• PRIVATE_LINK_CONNECTION_NAME: nome da conexão de serviço do link privado.
• STATUS: Approved ou Rejected.

az iot du account private-endpoint-connection set \
    --name <ACCOUNT_NAME> \
    --connection-name <PRIVATE_LINK_CONNECTION_NAME> \
    --status <STATUS> \
    --desc 'Optional description'