Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Utilize o portal do Azure e a CLI do Azure para gerir dispositivos através 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 gestão de gémeos digitais disponíveis no portal do Azure ou na CLI do Azure para gerir gémeos digitais remotamente. Para obter informações sobre como desenvolver aplicações de dispositivo para lidar com alterações nos gêmeos digitais, consulte Introdução aos gêmeos digitais.
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. Uma aplicação ou um utilizador de back-end pode atualizar as propriedades desejadas de 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 IoT Hub ou Compreender e usar gémeos de módulo no IoT Hub.
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 e o tamanho certos 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, depois 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 de gêmeos, consulte Consultas para gêmeos de dispositivos e módulos do Hub IoT.
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 baseando-se nos detalhes do gêmeo digital 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 réplicas de dispositivo usando tarefas
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.