Como vincular e gerenciar hubs IoT

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

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

1. No menu esquerdo 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 selecionado 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 Guardar.

Use o comando az iot dps linked-hub create Azure CLI para vincular um hub IoT à sua 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 . Este comando deixa as configurações de política de alocação de peso e Aplicar alocação em seus padrões, mas você pode especificar valores para essas configurações 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

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

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

1. No menu esquerdo 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 Peso de 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. Guarde as definições.

Com a CLI do Azure, você pode atualizar as configurações de Peso de 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 comando a seguir define o peso de 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 --set parâmetro junto com a cadeia de conexão para a política de acesso compartilhado do hub IoT que deseja usar. Para obter detalhes, consulte Atualizar chaves para hubs IoT vinculados.

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

1. No menu esquerdo 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 hubs IoT que você 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 comando a seguir 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 o portal do Azure. Em vez disso, você precisa excluir o hub IoT vinculado da sua instância 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 para Peso de alocação e Política de alocação Aplicar. Você precisará desses valores quando revincular o hub IoT à sua instância DPS mais tarde. 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 sua escolha quando solicitado.

6. Navegue de volta para sua 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 DPS.

8. Siga as etapas na seção Adicionar um hub IoT vinculado para revincular o hub IoT à sua instância DPS com a nova cadeia de conexão para a política.

9. Se você precisar restaurar o peso da alocação e aplicar as configurações da política de alocação, siga as etapas na 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 Azure CLS:

1. Use o comando az iot hub policy renew-key para trocar ou regenerar as chaves simétricas para a política de acesso compartilhado no hub IoT. Por exemplo, o comando a seguir renova a chave primária para a 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 para a política de acesso compartilhado. Por exemplo, o comando a seguir 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 encontrar a posição do hub IoT na coleção de hubs IoT vinculados para sua instância DPS. Por exemplo, o comando a seguir obtém a cadeia de conexão primária para a política de acesso compartilhado do proprietário 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 mantidos pela sua instância DPS. Neste caso, é o primeiro hub IoT da 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 para o hub IoT vinculado. Use o --set parâmetro e a posição do hub IoT vinculado na properties.iotHubs[] tabela para direcionar o hub IoT. Por exemplo, o comando a seguir 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"