Come gestire i dispositivi usando i tag dei dispositivi gemelli in hub IoT di Azure

Articolo
03/17/2023

Questo articolo illustra come usare i tag per gestire i dispositivi IoT usando i tag dei dispositivi gemelli

I tag dei dispositivi gemelli possono essere usati come strumento potente per organizzare i dispositivi. Ciò è particolarmente importante quando si hanno più tipi di dispositivi all'interno delle soluzioni IoT, è possibile usare i tag per impostare tipi, posizioni e così via. Per esempio:

{
    "deviceId": "mydevice1",
    "status": "enabled",
    "connectionState": "Connected",
    "cloudToDeviceMessageCount": 0,
    "authenticationType": "sas",
    "tags": {
        "deploymentLocation": {
            "building": "43",
            "floor": "1"
        },
		"deviceType":"HDCamera"
    },
    "properties": {
     ...
    }
}

Prerequisiti

Un hub IoT. Crearne uno con l'interfaccia della riga di comando o il portale di Azure.
Almeno due dispositivi registrati. Registrare i dispositivi nel portale di Azure.

Aggiungere e visualizzare i tag dei dispositivi gemelli usando il portale di Azure

Questa sezione illustra come creare un hub IoT usando il portale di Azure.

Accedere al portale di Azure e passare al hub IoT.
Selezionare la scheda Dispositivo nel riquadro di spostamento a sinistra.
Selezionare i dispositivi desiderati, selezionare Assegna tag.
Nella visualizzazione aperta è possibile visualizzare i tag già presenti nei dispositivi. Per aggiungere un nuovo tag di base, specificare un nome e un valore per il tag. Il formato per la coppia nome e valore è disponibile nel formato Tag e proprietà. Selezionare Salva per salvare il tag.
Dopo il salvataggio, è possibile visualizzare i tag aggiunti selezionando di nuovo Assegna tag .

Aggiungere e visualizzare tag annidati

Seguendo l'esempio precedente, è possibile aggiungere un tag annidato selezionando la scheda avanzata in Assegna tag e aggiungendo un oggetto JSON annidato con due valori.
```
{
    "deploymentLocation": {
        "building": "43",
        "floor": "1"
    }
}
```
Selezionare Salva
Selezionare di nuovo i dispositivi e selezionare Assegna tag per visualizzare lo screenshot dei tag appena aggiunti

Filtro dei dispositivi con tag del dispositivo gemello

I tag dei dispositivi gemelli sono un ottimo modo per raggruppare i dispositivi in base al tipo, alla posizione e così via ed è possibile gestire i dispositivi filtrando i tag dei dispositivi.

Selezionare + Aggiungi filtro e selezionare Tag dispositivo come tipo di filtro
Immettere il nome e il valore del tag desiderati, selezionare Applica per recuperare l'elenco di dispositivi che corrispondono ai criteri

Aggiornare ed eliminare i tag dei dispositivi gemelli da più dispositivi usando il portale di Azure

Selezionare i due o più dispositivi, selezionare Assegna tag.
Nel pannello aperto è possibile aggiornare i tag esistenti digitando il nome del tag di destinazione nel campo Nome e la nuova stringa nel campo Valore .
Per eliminare un tag da più dispositivi, digitare il nome del tag di destinazione nel campo Nome e selezionare il pulsante Elimina tag .
Selezionare Salva per eliminare il tag dai dispositivi che contiene il nome del tag corrispondente.

Gestione dei tag dei dispositivi gemelli tramite l'interfaccia della riga di comando di Azure

La sezione seguente illustra alcuni esempi di assegnazione di tag tramite l'interfaccia della riga di comando di Azure. Per riferimenti completi all'interfaccia della riga di comando del dispositivo gemello

Al prompt dei comandi eseguire il comando per l'accesso:
```
az login
```
Seguire le istruzioni per l'autenticazione tramite il codice e accedere all'account Azure con un Web browser.
Se si usano più sottoscrizioni di Azure, effettuando l'accesso ad Azure è possibile accedere a tutti gli account Azure associati alle credenziali. Usare az account list per visualizzare l'elenco completo degli account:
```
az account list
```
Usare il comando seguente per selezionare la sottoscrizione che si vuole usare per eseguire i comandi per creare l'hub IoT. È possibile usare il nome o l'ID della sottoscrizione dall'output del comando precedente:
```
az account set --subscription {your subscription name or id}
```
Il comando seguente abilita le notifiche dei file e imposta le proprietà di notifica dei file sui valori predefiniti. La durata della notifica di caricamento dei file è impostata su un'ora e la durata del blocco è impostata su 60 secondi.
```
az iot hub device-twin update -n {iothub_name} \
    -d {device_id} --tags '{"country": "USA"}'
```

È possibile aggiungere tag annidati complessi importando un file JSON o aggiungendo json direttamente all'input:

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"}}'

Usare il comando in un tag esistente per aggiornare il valore:

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

Il comando seguente rimuove il tag aggiunto impostando il valore su Null.

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

Nota

Se si usa la modalità PowerShell o CloudShell PowerShell>, è necessario aggiungere una barra '\' per eseguire l'escape di tutte le virgolette doppie. Esempio: --tags '{\"country\":\"US\"}'

Creare processi per impostare i tag usando l'interfaccia della riga di comando di Azure

Per riferimenti completi all'interfaccia della riga di comando dei processi di hub IoT

Passaggi successivi

In questa esercitazione si è appreso come usare i dispositivi gemelli. Altri argomenti di interesse disponibili nella Guida per sviluppatori dell'hub IoT:

Per provare alcuni dei concetti descritti in questo articolo, vedere le esercitazioni sull'hub IoT seguenti:

Share via