Como gerir dispositivos com etiquetas de dispositivo duplo no Hub IoT do Azure

Artigo
03/18/2023

Este artigo demonstra como utilizar etiquetas para gerir dispositivos IoT com etiquetas de dispositivo duplo

As etiquetas de dispositivo duplo podem ser utilizadas como uma ferramenta avançada para ajudá-lo a organizar os seus dispositivos. Isto é especialmente importante quando tem vários tipos de dispositivos nas suas soluções de IoT, pode utilizar etiquetas para definir tipos, localizações, 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 uma com a CLI ou a portal do Azure.
Pelo menos dois dispositivos registados. Registar dispositivos no portal do Azure.

Adicionar e ver etiquetas de dispositivo duplo com o portal do Azure

Esta secção descreve como criar um hub IoT com o portal do Azure.

Inicie sessão no portal do Azure e aceda ao seu Hub IoT.
Selecione o separador Dispositivo no painel de navegação esquerdo.
Selecione os dispositivos pretendidos e selecione Atribuir Etiquetas.
Na vista aberta, pode ver as etiquetas que os dispositivos já têm. Para adicionar uma nova etiqueta básica, forneça um nome e um valor para a etiqueta. O formato do par de nomes e valores encontra-se no formato Etiquetas e propriedades. Selecione Guardar para guardar a etiqueta.
Depois de guardar, pode ver as etiquetas que foram adicionadas ao selecionar Atribuir Etiquetas novamente.

Adicionar e ver etiquetas aninhadas

Seguindo o exemplo acima, pode adicionar uma etiqueta aninhada ao selecionar o separador avançado em Atribuir Etiquetas e adicionar um objeto json aninhado com dois valores.
```
{
    "deploymentLocation": {
        "building": "43",
        "floor": "1"
    }
}
```
Selecione Guardar
Selecione os dispositivos novamente e selecione Atribuir Etiquetas para ver as etiquetas adicionadas recentemente

Filtrar dispositivos com etiquetas de dispositivo duplo

As etiquetas de dispositivo duplo são uma excelente forma de agrupar dispositivos por tipo, localização, etc., e pode gerir os seus dispositivos ao filtrar através de etiquetas de dispositivo.

Selecione + Adicionar filtro e selecione Etiqueta de Dispositivo como o tipo de filtro
Introduza o nome e o valor de etiqueta pretendidos, selecione Aplicar para obter a lista de dispositivos que corresponde aos critérios

Atualizar e eliminar etiquetas de dispositivo duplo de vários dispositivos com o portal do Azure

Selecione os dois ou mais dispositivos e selecione Atribuir Etiquetas.
No painel aberto, pode atualizar as etiquetas existentes ao escrever o nome da etiqueta de destino no campo Nome e a nova cadeia no campo Valor .
Para eliminar uma etiqueta de vários dispositivos, escreva o nome da etiqueta de destino no campo Nome e selecione o botão Eliminar Etiquetas .
Selecione Guardar para eliminar a etiqueta dos dispositivos que contêm o nome da etiqueta correspondente.

Gerir etiquetas de dispositivo duplo com a CLI do Azure

A secção seguinte explica vários exemplos de etiquetagem com a CLI do Azure. Para referências completas à CLI do dispositivo duplo

Na linha de comandos, execute o comando login:
```
az login
```
Siga as instruções para se autenticar com o código e inicie sessão na sua conta do Azure através de um browser.
Se tiver várias subscrições do Azure, iniciar sessão no Azure dá-lhe acesso a todas as contas do Azure associadas às suas credenciais. Utilize a lista az account para ver a lista completa de contas:
```
az account list
```
Utilize o seguinte comando para selecionar a subscrição que pretende utilizar para executar os comandos para criar o seu hub IoT. Pode utilizar o nome ou o ID da subscrição da saída do comando anterior:
```
az account set --subscription {your subscription name or id}
```
O comando seguinte ativa as notificações de ficheiros e define as propriedades de notificação de ficheiro para os respetivos valores predefinidos. (O tempo de notificação de carregamento do ficheiro está definido para uma hora e a duração do bloqueio está definida para 60 segundos.)
```
az iot hub device-twin update -n {iothub_name} \
    -d {device_id} --tags '{"country": "USA"}'
```

Pode adicionar etiquetas aninhadas complexas ao importar um ficheiro json ou ao adicionar 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"}}'

Utilize o comando numa etiqueta existente para atualizar o valor:

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

O comando seguinte remove a etiqueta que foi adicionada ao definir o valor como nulo.

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

Nota

Se estiver a utilizar o powerShell ou o modo do PowerShell do CloudShell>, tem de adicionar uma barra "\" para escapar a todas as aspas. Exemplo: --tags '{\"country\":\"US\"}'

Criar tarefas para definir etiquetas com a CLI do Azure

Para referências completas à CLI de Tarefas do Hub IoT

Passos seguintes

Agora que ficou a conhecer os dispositivos duplos, poderá estar interessado nos seguintes tópicos Hub IoT guia para programadores:

Para experimentar alguns dos conceitos descritos neste artigo, veja os seguintes tutoriais Hub IoT:

Share via