Správa zařízení pomocí značek dvojčat zařízení v Azure IoT Hub

Článek
06/24/2023

Tento článek ukazuje, jak používat značky ke správě zařízení IoT pomocí značek dvojčat zařízení.

Značky dvojčat zařízení se dají použít jako výkonný nástroj, který vám pomůže uspořádat vaše zařízení. To je zvlášť důležité, pokud máte v rámci řešení IoT více druhů zařízení, můžete použít značky k nastavení typů, umístění atd. Příklad:

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

Požadavky

IoT Hub. Vytvořte ho pomocí rozhraní příkazového řádku nebo Azure Portal.
Alespoň dvě registrovaná zařízení. Zaregistrujte zařízení v Azure Portal.

Přidání a zobrazení značek dvojčat zařízení pomocí Azure Portal

Tato část popisuje, jak vytvořit centrum IoT pomocí Azure Portal.

Přihlaste se k Azure Portal a přejděte na IoT Hub.
V levém navigačním panelu vyberte kartu Zařízení .
Vyberte požadovaná zařízení a vyberte Přiřadit značky.
V otevřeném zobrazení uvidíte značky, které už zařízení mají. Pokud chcete přidat novou základní značku, zadejte název a hodnotu značky. Formát dvojice název a hodnota se nachází ve formátu značek a vlastností. Výběrem možnosti Uložit značku uložte.
Po uložení můžete přidané značky zobrazit tak, že znovu vyberete Přiřadit značky .

Přidání a zobrazení vnořených značek

Podle výše uvedeného příkladu můžete přidat vnořenou značku tak, že v přiřadit značky vyberete kartu Upřesnit a přidáte vnořený objekt JSON se dvěma hodnotami.
```
{
    "deploymentLocation": {
        "building": "43",
        "floor": "1"
    }
}
```
Vyberte Uložit
Znovu vyberte zařízení a vyberte Přiřadit značky . Zobrazí se nově přidané značky

Filtrování zařízení pomocí značek dvojčat zařízení

Značky dvojčat zařízení jsou skvělým způsobem, jak seskupit zařízení podle typu, umístění atd. A můžete je spravovat filtrováním prostřednictvím značek zařízení.

Vyberte + Přidat filtr a jako typ filtru vyberte Značka zařízení .
Zadejte požadovaný název a hodnotu značky, výběrem možnosti Použít načtěte seznam zařízení, která odpovídají kritériím

Aktualizace a odstranění značek dvojčat zařízení z více zařízení pomocí Azure Portal

Vyberte dvě nebo více zařízení a vyberte Přiřadit značky.
Na otevřeném panelu můžete aktualizovat existující značky zadáním názvu cílové značky do pole Název a nového řetězce do pole Hodnota .
Pokud chcete odstranit značku z více zařízení, zadejte název cílové značky do pole Název a vyberte tlačítko Odstranit značky .
Vyberte Uložit a odstraňte značku ze zařízení, která obsahují odpovídající název značky.

Správa značek dvojčat zařízení pomocí Azure CLI

Následující část vás provede několika příklady označování pomocí Azure CLI. Úplné odkazy na rozhraní příkazového řádku dvojčete zařízení

Na příkazovém řádku spusťte příkaz pro přihlášení:
```
az login
```
Postupujte podle pokynů pro ověření pomocí kódu a přihlaste se ke svému účtu Azure ve webovém prohlížeči.
Pokud máte více předplatných Azure, přihlášením k Azure získáte přístup ke všem účtům Azure přidruženým k vašim přihlašovacím údajům. Úplný seznam účtů zobrazíte pomocí příkazu az account list :
```
az account list
```
Pomocí následujícího příkazu vyberte předplatné, které chcete použít ke spuštění příkazů k vytvoření centra IoT. Můžete použít název nebo ID předplatného z výstupu předchozího příkazu:
```
az account set --subscription {your subscription name or id}
```
Následující příkaz povolí oznámení souborů a nastaví vlastnosti oznámení souboru na výchozí hodnoty. (Hodnota TTL (Time to Live) oznámení o nahrání souboru je nastavená na jednu hodinu a doba uzamčení je nastavená na 60 sekund.)
```
az iot hub device-twin update -n {iothub_name} \
    -d {device_id} --tags '{"country": "USA"}'
```

Složité vnořené značky můžete přidat importováním souboru JSON nebo přidáním kódu JSON přímo do vstupu:

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

K aktualizaci hodnoty použijte příkaz u existující značky:

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

Následující příkaz odebere přidanou značku nastavením hodnoty na hodnotu null.

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

Poznámka

Pokud používáte powershellový nebo cloudshellový>režim PowerShellu, musíte přidat lomítko \, aby se uvozily všechny dvojité uvozovky. Příklad: --tags '{\"country\":\"US\"}'

Vytváření úloh pro nastavení značek pomocí Azure CLI

Úplné odkazy na rozhraní příkazového řádku IoT Hub Jobs

Další kroky

Teď jste se seznámili s dvojčaty zařízení a mohli byste se zajímat o následující témata IoT Hub příručky pro vývojáře:

Pokud si chcete vyzkoušet některé koncepty popsané v tomto článku, projděte si následující IoT Hub kurzy:

Share via