Como gerenciar dispositivos usando marcas de dispositivo gêmeo no Hub IoT do Azure

Artigo
03/17/2023

Este artigo demonstra como usar marcas para gerenciar dispositivos IoT usando marcas de dispositivo gêmeo

As marcas de dispositivo gêmeo podem ser usadas como uma ferramenta poderosa para ajudar a organizar seus dispositivos. Isso é importante especialmente quando você tem vários tipos de dispositivos em suas soluções de IoT, é possível usar marcas 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": {
     ...
    }
}

Pré-requisitos

Um hub IoT. Crie um com a CLI ou o portal do Azure.
pelo menos dois dispositivos registrados. Registrar dispositivos no portal do Azure.

Adicionar e exibir marcas de dispositivo gêmeo usando o portal do Azure

Esta seção descreve como criar um hub IoT usando o portal do Azure.

Entre no portal do Azure e acesse o Hub IoT.
Selecione a guia Dispositivo no painel de navegação à esquerda.
Selecione os dispositivos desejados e Atribuir Marcas.
No modo de exibição aberto, é possível ver as marcas que os dispositivos já têm. Para adicionar uma nova marca básica, forneça um nome e um valor para a marca. O formato do par nome e valor é encontrado em Formato de marcas e propriedades. Selecione Salvar para salvar a marca.
Depois de salvar, você pode exibir as marcas que foram adicionadas selecionando Atribuir Marcas novamente.

Adicionar e exibir marcas aninhadas

Seguindo o exemplo acima, você pode adicionar uma marca aninhada selecionando a guia avançada em Atribuir Marcas e adicionar um objeto JSON aninhado com dois valores.
```
{
    "deploymentLocation": {
        "building": "43",
        "floor": "1"
    }
}
```
Selecione Salvar
Selecione os dispositivos novamente e Atribuir Marcas para exibir as marcas recém-adicionadas

Filtragem de dispositivos com marcas de dispositivo gêmeo

As marcas de dispositivo gêmeo são uma ótima maneira de agrupar dispositivos por tipo, localização etc., Além disso, você pode gerenciar seus dispositivos com a filtragem por meio das marcas de dispositivo.

Selecione + Adicionar filtro e selecione Marca de Dispositivo como o tipo de filtro
Insira o nome e o valor da marca desejados, selecione Aplicar para recuperar a lista de dispositivos que correspondem aos critérios

Atualizar e excluir marcas de dispositivo gêmeo de vários dispositivos usando o portal do Azure

Selecione os dois ou mais dispositivos, selecione Atribuir Marcas.
No painel aberto, você pode atualizar as marcas existentes digitando o nome da marca de destino no campo Nome e a nova cadeia de caracteres no campo Valor.
Para excluir uma marca de vários dispositivos, digite o nome da marca de destino no campo Nome e selecione o botão Excluir Marcas.
Selecione Salvar para excluir a marca dos dispositivos que contêm o nome da marca correspondente.

Gerenciar marcas de dispositivo gêmeo usando a CLI do Azure

A seção a seguir é um passo a passo com vários exemplos de marcação usando a CLI do Azure. Para referências completas à CLI do dispositivo gêmeo

No prompt de comando, execute o comando de logon:
```
az login
```
Siga as instruções de autenticação usando o código e entre em sua conta do Azure por meio de um navegador da Web.
Se você tiver várias assinaturas do Azure, entrar o Azure lhe dará acesso a todas as contas do Azure associadas às suas credenciais. Use a az account list para exibir a lista completa de contas:
```
az account list
```
Use o seguinte comando para selecionar a assinatura que você quer usar e executar os comandos para criar o Hub IoT. Você pode usar a ID ou nome da assinatura da saída do comando anterior:
```
az account set --subscription {your subscription name or id}
```
O comando a seguir habilita as notificações de arquivo e define as propriedades de notificação de arquivo para seus valores padrão. (O tempo de notificação de upload do arquivo é definido para uma hora e a duração do bloqueio é definida para 60 segundos.)
```
az iot hub device-twin update -n {iothub_name} \
    -d {device_id} --tags '{"country": "USA"}'
```

Você pode adicionar marcas aninhadas complexas importando um arquivo JSON ou adicionando JSON diretamente à entrada:

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags /path/to/file

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags '{"country":{"county":"king"}}'

Use o comando em uma marca existente para atualizar o valor:

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags '{"country": "Germany"}'

O comando a seguir remove a marca que foi adicionada definindo o valor como nulo.

az iot hub device-twin update --name {your iot hub name} \
    -d {device_id} --tags '{"country": null}'

Observação

Se você estiver usando o modo do PowerShell>do CloudShell ou Powershell, precisará adicionar uma barra "\" para escapar de todas as aspas duplas. Exemplo: --tags '{\"country\":\"US\"}'

Criar trabalhos para definir marcas usando a CLI do Azure

Para obter referências completas à CLI de trabalhos do Hub IoT

Próximas etapas

Agora que você aprendeu sobre dispositivos gêmeos, pode ser interessante ler os seguintes tópicos do Guia do desenvolvedor do Hub IoT:

Para experimentar alguns dos conceitos descritos neste artigo, consulte os tutoriais do Hub IoT a seguir:

Compartilhar via