Como vincular e gerenciar hubs IoT

No portal do Azure, você pode vincular um hub IoT no menu à esquerda da instância do DPS ou no registro ao criar ou atualizar um registro. Nos dois casos, o hub IoT tem como escopo a instância do DPS (não apenas o registro).

Para vincular um hub IoT à instância do DPS no portal do Azure:

1. No menu à esquerda da instância do DPS, selecione Hubs IoT vinculados.

2. Na parte superior da página, selecione + Adicionar.

3. Na página Adicionar link ao hub IoT, selecione a assinatura que contém o hub IoT e escolha o nome do hub IoT na lista Hub IoT.

4. Depois de selecionar o hub IoT, escolha uma política de acesso que o DPS usará para se conectar ao hub IoT. A lista Política de Acesso mostra todas as políticas de acesso compartilhado definidas no Hub IoT selecionada que têm as permissões RegistryWrite e ServiceConnect definidas. O padrão é a política iothubowner. Selecione a política que deseja usar.

5. Selecione Salvar.

Use o comando az iot dps linked-hub create da CLI do Azure para vincular um hub IoT à instância do DPS.

Por exemplo, o comando a seguir vincula um hub IoT chamado MyExampleHub usando uma cadeia de conexão para sua política de acesso compartilhado iothubowner. Esse comando deixa as configurações Peso da alocação e Aplicar política de alocação com os valores padrão, mas você poderá especificar valores para elas se desejar.

az iot dps linked-hub create --dps-name MyExampleDps --resource-group MyResourceGroup --connection-string "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=XNBhoasdfhqRlgGnasdfhivtshcwh4bJwe7c0RIGuWsirW0=" --location westus

Na portal do Azure, você pode atualizar as configurações Peso da alocação e Aplicar política de alocação.

Para atualizar as configurações de um hub IoT vinculado usando o portal do Azure:

1. No menu à esquerda da instância do DPS, selecione Hubs IoT vinculados e, em seguida, selecione o Hub IoT na lista.

2. Na página Detalhes do hub IoT vinculado:

   

   • Use o controle deslizante de Peso da alocação ou a caixa de texto para escolher um peso entre um e 1000. O padrão é um.

   • Defina a opção Aplicar política de alocação para especificar se o hub IoT vinculado deve ser incluído na alocação.

3. Salve suas configurações.

Com a CLI do Azure, você pode atualizar as configurações Peso da alocação, Aplicar política de alocação e Cadeia de conexão.

Use o comando az iot dps linked-hub update para atualizar o peso da alocação ou aplicar as configurações de políticas de alocação. Por exemplo, o seguinte comando define o peso da alocação e aplica a política de alocação para um hub IoT vinculado:

az iot dps linked-hub update --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub --allocation-weight 2 --apply-allocation-policy true

Use o comando az iot dps update para atualizar a cadeia de conexão de um hub IoT vinculado. Você pode usar o parâmetro --set junto com a cadeia de conexão da política de acesso compartilhado do hub IoT que deseja usar. Para conhecer os detalhes, confira Atualizar chaves para hubs IoT vinculados.

Para excluir um hub IoT vinculado da instância do DPS no portal do Azure:

1. No menu à esquerda da instância do DPS, selecione Hubs IoT vinculados.

2. Na lista de hubs IoT, marque a caixa de seleção ao lado do hub IoT ou dos hubs IoT que deseja excluir. Em seguida, selecione Excluir na parte superior da página e confirme sua escolha quando solicitado.

Use o comando az iot dps linked-hub delete para remover um hub IoT vinculado da instância do DPS. Por exemplo, o seguinte comando remove o hub IoT chamado MyExampleHub:

az iot dps linked-hub delete --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub

Não é possível atualizar a configuração da cadeia de conexão para um Hub IoT vinculado ao usar portal do Azure. Em vez disso, você precisa excluir o Hub IoT vinculado da sua instância do DPS e, em seguida, adicioná-lo novamente.

Para atualizar chaves simétricas para um hub IoT vinculado no portal do Azure:

1. No menu esquerdo da sua instância do DPS no portal do Azure, selecione o Hub IoT para o qual você deseja atualizar uma ou mais chaves.

2. Na página Detalhes do Hub IoT vinculado, anote os valores de Peso de alocação e Aplicar política de alocação. Você precisará desses valores quando vincular novamente o Hub IoT à sua instância do DPS posteriormente. Em seguida, selecione Gerenciar Recurso para ir para o hub IoT.

3. No menu esquerdo do hub IoT, em Configurações de segurança, selecione Políticas de acesso compartilhado.

4. Em Políticas de acesso compartilhado, em Gerenciar políticas de acesso compartilhado, selecione a política que sua instância do DPS usa para se conectar ao hub IoT vinculado.

5. Na parte superior da página, selecione Regenerar chave primária, Regenerar chave secundária ou Trocar chaves e confirme a escolha quando solicitado.

6. Navegue de volta para a instância do DPS.

7. Siga as etapas na seção Excluir um Hub IoT vinculado para excluir o Hub IoT da sua instância do DPS.

8. Siga as etapas da seção Adicionar um Hub IoT vinculado para vincular novamente o Hub IoT à instância do DPS com a nova cadeia de conexão para a política.

9. Se precisar restaurar o peso da alocação e aplicar as configurações da política de alocação, siga as etapas da seção Atualizar um Hub IoT vinculado usando os valores salvos na etapa 2.

Para atualizar chaves simétricas para um hub IoT vinculado com o CLS do Azure:

1. Use o comando az iot hub policy renew-key para trocar ou regenerar as chaves simétricas da política de acesso compartilhado no hub IoT. Por exemplo, o seguinte comando renova a chave primária da política de acesso compartilhado iothubowner em um hub IoT:

   az iot hub policy renew-key --hub-name MyExampleHub --name owner --rk primary
   

2. Use o comando az iot hub connection-string show para obter a nova cadeia de conexão da política de acesso compartilhado. Por exemplo, o seguinte comando obtém a cadeia de conexão primária para a política de acesso compartilhado iothubowner para a qual a chave primária foi regenerada no comando anterior:

   az iot hub connection-string show --hub-name MyExampleHub --policy-name owner --key-type primary
   

3. Use o comando az iot dps linked-hub list para localizar a posição do hub IoT na coleção de hubs IoT vinculados de sua instância do DPS. Por exemplo, o seguinte comando obtém a cadeia de conexão primária para a política de acesso compartilhado owner para a qual a chave primária foi regenerada no comando anterior:

   az iot dps linked-hub list --dos-name MyExampleDps
   

   A saída mostra a posição do Hub IoT vinculado para o qual você deseja atualizar a cadeia de conexão na tabela de hubs IoT vinculados mantida pela instância do DPS. Nesse caso, é o primeiro hub IoT na lista, MyExampleHub.

   [
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "MyExampleHub.azure-devices.net"
   },
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "NyExampleHub-2.azure-devices.net"
   }
   ]
   

4. Use o comando az iot dps update para atualizar a cadeia de conexão do hub IoT vinculado. Use o parâmetro --set e a posição do hub IoT vinculado na tabela properties.iotHubs[] para ter como destino o hub IoT. Por exemplo, o seguinte comando atualiza a cadeia de conexão para MyExampleHub retornada primeiro no comando anterior:

   az iot dps update --name MyExampleDps --set properties.iotHubs[0].connectionString="HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=NewTokenValue"