Atualização de dispositivo para gerenciamento de recursos do Hub IoT

Um hub IoT. É recomendável usar uma camada S1 (Padrão) ou superior.

• Um hub IoT. É recomendável usar uma camada S1 (Padrão) ou superior.

• Um ambiente da CLI do Azure:

  • Use o ambiente Bash na Azure Cloud Shell.

    

  • Ou, se preferir executar 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 descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

    • Quando solicitado, instale as extensões da CLI do Azure na primeira utilização. Os comandos neste artigo usam a extensão azure-iot . Execute az extension update --name azure-iot para se certificar de que está a utilizar a versão mais recente da extensão.

1. No portal do Azure, selecione Criar um de Recursos e procure "Atualização de dispositivo para o Hub IoT"

   

2. Selecione Criar>Atualização de Dispositivo para o Hub IoT

3. Na guia Noções básicas, forneça as seguintes informações para a sua conta de Atualização de Dispositivo:

   • Subscrição: A subscrição do Azure a ser associada à conta de Dispositivo de Atualização.
   • Grupo de recursos: Um grupo de recursos novo ou existente.
   • Nome: Um nome para a sua conta.
   • Localização: A região do Azure onde sua conta estará localizada. Para obter informações sobre quais regiões oferecem suporte à Atualização de Dispositivo para o Hub IoT, consulte página Produtos do Azure por região.

   Observação

   Sua conta de Atualização de Dispositivo não precisa estar na mesma região que seus hubs IoT, mas para um melhor desempenho é recomendável mantê-los geograficamente próximos.

   

4. Opcionalmente, você pode marcar a caixa para atribuir a função de administrador de Atualização de Dispositivo a si mesmo. Você também pode usar as etapas listadas na seção Configurar funções de controle de acesso para fornecer uma combinação de funções a usuários e aplicativos para o nível certo de acesso.

   Você precisa ter permissões de Proprietário ou Administrador de Acesso de Usuário em sua assinatura para gerenciar funções.

5. Selecione Próximo: Instância

   Uma instância de Atualização de Dispositivo está associada a um único hub IoT. Selecione o hub IoT que será usado com a Atualização de Dispositivo. Quando se vincula um hub IoT a uma instância de Atualização de Dispositivo, uma nova política de acesso partilhado é criada automaticamente, concedendo permissões à Atualização de Dispositivo para funcionar com o Hub IoT (escrita no registo e ligação ao serviço). Esta política garante que o acesso seja limitado apenas à Atualização de Dispositivo.

6. Na guia Instância, forneça as seguintes informações para a sua instância de Device Update:

   • Nome: Um nome para a sua instância.
   • Detalhes do IoT Hub: Selecione um IoT hub para ligar a esta instância.

   

7. Selecione Seguinte: Rever e Criar. Após a validação, selecione Criar.

   

8. Você verá que sua implantação está em andamento. O status da implantação mudará para "concluído" em alguns minutos. Quando isso acontecer, selecione Ir para o recurso

   

Use o comando az iot device-update create para criar uma nova conta de Atualização de Dispositivo.

Substitua os seguintes marcadores de posição pelas suas próprias informações:

• <resource_group>: Um grupo de recursos existente na sua subscrição.

• <account_name>: Um nome para a sua conta de Atualização de Dispositivo.

• <região>: A região do Azure onde sua conta estará localizada. Para obter informações sobre quais regiões oferecem suporte à Atualização de Dispositivo para o Hub IoT, consulte página Produtos do Azure por região. Se nenhuma região for fornecida, o local do grupo de recursos será usado.

  Observação

  Sua conta de Atualização de Dispositivo não precisa estar na mesma região que seus hubs IoT, mas para um melhor desempenho é recomendável mantê-los geograficamente próximos.

az iot device-update account create --resource-group <resource_group> --account <account_name> --location <region>

Use o comando az iot device-update create para criar uma instância de Atualização de Dispositivo.

Uma instância de Atualização de Dispositivo está associada a um único hub IoT. Selecione o hub IoT que será usado com a Atualização de Dispositivo. Quando se vincula um hub IoT a uma instância de Atualização de Dispositivo, uma nova política de acesso partilhado é criada automaticamente, concedendo permissões à Atualização de Dispositivo para funcionar com o Hub IoT (escrita no registo e ligação ao serviço). Esta política garante que o acesso seja limitado apenas à Atualização de Dispositivo.

Substitua os seguintes marcadores de posição pelas suas próprias informações:

• <account_name>: O nome da conta de Atualização de Dispositivo à qual esta instância será associada.
• <instance_name>: Um nome para este exemplo.
• <iothub_id>: O ID do recurso para o hub IoT que será vinculado a esta instância. Você pode recuperar o seu ID de recurso do hub IoT usando o comando az iot hub show e consultando o valor do ID: az iot hub show -n <iothub_name> --query id.

az iot device-update instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

1. Na sua conta de Atualização de Dispositivo, selecione Controlo de Acesso (IAM) no menu de navegação.

   

2. Selecione Adicionar atribuições de função.

3. Na guia Função , selecione uma função de Atualização de Dispositivo entre as opções disponíveis:

   • Administrador de atualização de dispositivo
   • Leitor de atualização de dispositivo
   • Administrador de conteúdo de atualização de dispositivo
   • Leitor de Conteúdo para Atualização de Dispositivo
   • Administrador de implantações de atualização de dispositivos
   • Visualizador de atualizações de implantação de dispositivo

   Para obter mais informações, Saiba mais sobre o controlo de acesso baseado em funções no Device Update for IoT Hub.

   

4. Selecione Seguinte

5. Na guia Membros, selecione os usuários ou grupos aos quais você deseja atribuir a função.

   

6. Selecione Revisão + Atribuir

7. Revise as novas atribuições de função e selecione Revisar + atribuir novamente

8. Agora você está pronto para usar a Atualização de Dispositivo a partir do seu Hub IoT

As seguintes funções estão disponíveis para atribuir acesso à Atualização de Dispositivo:

• Administrador de atualização de dispositivo
• Leitor de atualização de dispositivo
• Administrador de conteúdo de atualização de dispositivo
• Leitor de Conteúdo para Atualização de Dispositivo
• Administrador de implantações de atualização de dispositivos
• Visualizador de atualizações de implantação de dispositivo

Para obter mais informações, Saiba mais sobre o controlo de acesso baseado em funções no Device Update for IoT Hub.

Use o comando az role assignment create para configurar o controlo de acesso para a sua conta de Atualização de Dispositivo.

Substitua os seguintes marcadores de posição pelas suas próprias informações:

• <função>: A função Atualização de Dispositivo que você está atribuindo.
• <user_group>: O usuário ou grupo ao qual você deseja atribuir a função.
• <account_id>: O ID do recurso para a conta de Atualização de Dispositivo à qual o usuário ou grupo terá acesso. Você pode recuperar o ID do recurso usando o comando az iot device-update account show e consultando o valor do ID: az iot device-update account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

1. No portal do Azure, navegue até o hub IoT conectado à sua instância de Atualização de Dispositivo.
2. Selecione Controle de Acesso (IAM) no menu de navegação.
3. Selecione Adicionar>Adicionar atribuição de função.
4. Na guia de Função, selecione Colaborador de Dados do Hub IoT. Selecione Seguinte.
5. Para Atribuir acesso a, selecione Utilizador, grupo ou principal do serviço.
6. Selecione Selecionar Membros e procure por 'Azure Device Update'
7. Selecione Próxima>Revisão + Atribuir

Para validar que você definiu as permissões corretamente:

1. No portal do Azure, navegue até o hub IoT conectado à sua instância de Atualização de Dispositivo.
2. Selecione Controle de Acesso (IAM) no menu de navegação.
3. Selecione Verificar acesso.
4. Selecionar Usuário, grupo ou entidade de serviço e procurar por 'de Atualização de Dispositivo Azure'
5. Depois de clicar em Atualização de Dispositivo do Azure, verifique se o papel de Contribuidor de Dados do Hub IoT está listado em Atribuições de Função.

Use o comando az role assignment create para criar uma atribuição de função para o principal de serviço de Atualização de Dispositivo do Azure.

Substitua <resource_id> pelo ID do recurso do seu hub IoT. Você pode recuperar o ID do recurso usando o comando az iot hub show e consultando o valor de ID: az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

1. Para ver todas as contas do Device Update, use o portal do Azure para pesquisar o serviço Device Update para Hubs IoT.

   • Use o menu suspenso Agrupamento para agrupar a conta por assinatura, grupo de recursos, local e outras condições.
   • Selecione Adicionar de filtro para filtrar a lista de contas por grupo de recursos, localização, tags e outras condições.

2. Para exibir todas as instâncias em uma conta, navegue até essa conta no portal do Azure. Selecione Instâncias da seção Gerenciamento de instâncias do menu

   • Use a caixa de pesquisa para filtrar instâncias.

Para exibir todas as contas de Atualização de Dispositivo, use o comando az iot device-update account list.

az iot device-update account list 

Para visualizar todas as instâncias numa conta, utilize o comando az iot device-update instance list.

az iot device-update instance list --account <account_name>

Ambos os comandos list suportam operações adicionais de agrupamento e filtro. Use o argumento --query para localizar contas ou instâncias com base em condições como tags. Por exemplo, --query "[?tags.env == 'test']". Use o argumento --output para formatar os resultados. Por exemplo, --output table.