Como visualizar e atualizar dispositivos com base nas propriedades gêmeas do dispositivo
Use o portal do Azure e a CLI do Azure para gerenciar dispositivos por meio de gêmeos de dispositivo e gêmeos de módulo. Este artigo se concentra em gêmeos de dispositivo para simplificar, mas todos os conceitos e processos funcionam de maneira semelhante para gêmeos de módulo.
Este artigo descreve as tarefas de gerenciamento de gêmeos de dispositivo disponíveis no portal do Azure ou na CLI do Azure para gerenciar gêmeos de dispositivo remotamente. Para obter informações sobre como desenvolver aplicativos de dispositivo para lidar com alterações de gêmeos de dispositivo, consulte Introdução aos gêmeos de dispositivo.
No Hub IoT, um dispositivo gêmeo é um documento JSON que armazena informações de estado. Cada identidade de dispositivo é automaticamente associada a um dispositivo gêmeo quando é criada. Um aplicativo ou usuário de back-end pode atualizar dois elementos de um dispositivo gêmeo:
- Propriedades desejadas: as propriedades desejadas são metade de um conjunto vinculado de informações de estado. Um aplicativo ou usuário de back-end pode atualizar as propriedades desejadas em um gêmeo para comunicar uma alteração de estado desejada, enquanto um dispositivo pode atualizar as propriedades relatadas para comunicar seu estado atual.
- Tags: Você pode usar tags gêmeas de dispositivo para organizar e gerenciar dispositivos em suas soluções de IoT. Você pode definir tags para qualquer categoria significativa, como tipo de dispositivo, local ou função.
Para obter mais informações, consulte Compreender e usar gêmeos de dispositivo no Hub IoT ou Entender e usar gêmeos de módulo no Hub IoT.
Nota
Os recursos descritos neste artigo estão disponíveis somente na camada padrão do Hub IoT. Para obter mais informações sobre as camadas básica e padrão/gratuita do Hub IoT, consulte Escolha a camada certa do Hub IoT para sua solução.
Pré-requisitos
Prepare os seguintes pré-requisitos antes de começar.
Um hub IoT em sua assinatura do Azure. Se você ainda não tiver um hub, siga as etapas em Criar um hub IoT.
Um dispositivo registrado em seu hub IoT. Se você não tiver um dispositivo em seu hub IoT, siga as etapas em Registrar um dispositivo.
Compreender as tags para organização de dispositivos
As etiquetas gémeas de dispositivos podem ser utilizadas como uma ferramenta poderosa para o ajudar a organizar os seus dispositivos. Quando você tem vários tipos de dispositivos em suas soluções de IoT, pode usar tags para definir tipos, locais, etc. Por exemplo:
{
"deviceId": "mydevice1",
"status": "enabled",
"connectionState": "Connected",
"cloudToDeviceMessageCount": 0,
"authenticationType": "sas",
"tags": {
"deploymentLocation": {
"building": "43",
"floor": "1"
},
"deviceType":"HDCamera"
},
"properties": {
...
}
}
Ver e atualizar gémeos de dispositivos
Depois que uma identidade de dispositivo é criada, um gêmeo de dispositivo é criado implicitamente no Hub IoT. Você pode usar o portal do Azure ou a CLI do Azure para recuperar o gêmeo de dispositivo de um determinado dispositivo. Você também pode adicionar, editar ou remover tags e propriedades desejadas.
No Portal do Azure, navegue para o seu hub IoT.
No hub IoT, selecione Dispositivos na seção Gerenciamento de dispositivos do menu de navegação.
Na página Dispositivos, você verá uma lista de todos os dispositivos registrados em seu hub IoT. Se algum dos dispositivos já tiver tags em seus gêmeos de dispositivo, essas tags serão mostradas na coluna Tags .
Selecione o nome do dispositivo que pretende gerir.
Gorjeta
Se estiver a atualizar etiquetas, pode selecionar vários dispositivos e, em seguida, selecionar Atribuir etiquetas para as gerir como um grupo.
A página de detalhes do dispositivo exibe todas as tags atuais do dispositivo selecionado. Selecione editar ao lado do parâmetro Tags para adicionar, atualizar ou remover tags.
Gorjeta
Para adicionar ou atualizar tags aninhadas, selecione a guia Avançado e forneça o JSON.
Selecione Device twin para visualizar e atualizar o dispositivo twin JSON.
Você pode digitar diretamente na caixa de texto para atualizar as tags ou as propriedades desejadas. Para remover uma tag ou propriedade desejada, defina o valor do item como
null.Selecione Guardar para guardar as alterações.
De volta à página de detalhes do dispositivo, selecione Atualizar para atualizar a página para refletir suas alterações.
Se o dispositivo tiver identidades de módulo associadas, esses módulos também serão exibidos na página de detalhes do dispositivo. Selecione um nome de módulo e, em seguida, selecione Gêmeo de identidade do módulo para visualizar e atualizar o JSON gêmeo do módulo.
Consulta de gêmeos de dispositivo
O Hub IoT expõe os gêmeos de dispositivo para seu hub IoT como uma coleção de documentos chamada dispositivos. Você pode consultar dispositivos com base em seus valores gêmeos de dispositivo.
Esta seção descreve como executar consultas gêmeas no portal do Azure e na CLI do Azure. Para saber como escrever consultas gêmeas, consulte Consultas para dispositivos do Hub IoT e gêmeos de módulo.
No Portal do Azure, navegue para o seu hub IoT.
No hub IoT, selecione Dispositivos na seção Gerenciamento de dispositivos do menu de navegação.
Você pode usar um filtro ou uma consulta para encontrar dispositivos com base nos detalhes do gêmeo do dispositivo:
Encontre dispositivos usando um filtro:
Localizar dispositivos usando um filtro é o modo de exibição padrão no portal do Azure. Se não vir estes campos, selecione Localizar dispositivos utilizando um filtro.
Selecione Adicionar filtro e, em seguida, selecione Etiqueta de dispositivo como o tipo de filtro no menu pendente.
Insira o nome e o valor da tag desejados, selecione Aplicar para recuperar a lista de dispositivos que correspondem aos critérios.
Localizar dispositivos usando uma consulta:
Selecione Localizar dispositivos usando uma consulta.
Introduza a sua consulta na caixa de texto e, em seguida, selecione Executar consulta.
Atualizar gêmeos de dispositivo usando trabalhos
A capacidade de trabalhos pode executar atualizações gêmeas de dispositivos em um conjunto de dispositivos em um horário agendado. Para obter mais informações, consulte Agendar trabalhos em vários dispositivos.
Não há suporte para trabalhos no portal do Azure. Em vez disso, use a CLI do Azure.