Azure IoT Hub cihaz ikizi etiketlerini kullanarak cihazları yönetme

Makale
03/17/2023

Bu makalede cihaz ikizi etiketlerini kullanarak IoT cihazlarını yönetmek için etiketlerin nasıl kullanılacağı gösterilmektedir

Cihaz ikizi etiketleri, cihazlarınızı düzenlemenize yardımcı olmak için güçlü bir araç olarak kullanılabilir. Bu özellikle IoT çözümlerinizde birden çok cihaz türü olduğunda önemlidir; türleri, konumları vb. ayarlamak için etiketleri kullanabilirsiniz. Örneğin:

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

Önkoşullar

Bir IoT hub'ı. CLI veya Azure portal ile bir tane oluşturun.
En az iki kayıtlı cihaz. Cihazları Azure portal kaydedin.

Azure portal kullanarak cihaz ikizi etiketlerini ekleme ve görüntüleme

Bu bölümde, Azure portal kullanarak IoT hub'ını nasıl oluşturacağınız açıklanmaktadır.

Azure portal oturum açın ve IoT Hub gidin.
Sol gezinti bölmesinden Cihaz sekmesini seçin.
İstediğiniz cihazları seçin, Etiket Ata'yı seçin.
Açık görünümde, cihazların zaten sahip olduğu etiketleri görebilirsiniz. Yeni bir temel etiket eklemek için etiket için bir ad ve değer sağlayın. Ad ve değer çiftinin biçimi Etiketler ve özellikler biçiminde bulunur. Etiketi kaydetmek için Kaydet'i seçin.
Kaydettikten sonra, Etiket Ata'yı yeniden seçerek eklenen etiketleri görüntüleyebilirsiniz.

İç içe etiketleri ekleme ve görüntüleme

Yukarıdaki örneği izleyerek, Etiket Ata'daki gelişmiş sekmeyi seçerek iç içe etiket ekleyebilir ve iki değer içeren iç içe json nesnesi ekleyebilirsiniz.
```
{
    "deploymentLocation": {
        "building": "43",
        "floor": "1"
    }
}
```
Cihazları yeniden seçin ve etiketler ata'yı seçerek yeni eklenen etiketleri görüntüleyin

Cihazları cihaz ikizi etiketleriyle filtreleme

Cihaz ikizi etiketleri, cihazları türe, konuma vb. göre gruplandırmak için harika bir yoldur ve cihaz etiketlerini filtreleyerek cihazlarınızı yönetebilirsiniz.

+ Filtre ekle'yi seçin ve filtre türü olarak Cihaz Etiketi'ni seçin
İstediğiniz etiket adını ve değerini girin, Ölçütlerle eşleşen cihazların listesini almak için Uygula'yı seçin

Azure portal kullanarak cihaz ikizi etiketlerini birden çok cihazdan güncelleştirme ve silme

İki veya daha fazla cihazı seçin, Etiket Ata'yı seçin.
Açılan panelde, Ad alanına hedef etiket adını ve Değer alanına yeni dizeyi yazarak mevcut etiketleri güncelleştirebilirsiniz.
Bir etiketi birden çok cihazdan silmek için Ad alanına hedef etiket adını yazın ve Etiketleri Sil düğmesini seçin.
Etiketi eşleşen etiket adını içeren cihazlardan silmek için Kaydet'i seçin.

Azure CLI kullanarak cihaz ikizi etiketlerini yönetme

Aşağıdaki bölümde Azure CLI kullanarak etiketlemeye ilişkin çeşitli örneklere göz atabilirsiniz. Cihaz ikizi CLI'sına tam başvurular için

Komut isteminde oturum açma komutunu çalıştırın:
```
az login
```
Kodu kullanarak kimlik doğrulaması gerçekleştirmek için yönergeleri uygulayın ve bir web tarayıcısı üzerinden Azure hesabınızda oturum açın.
Birden fazla Azure aboneliğiniz varsa Azure’da oturum açtığınızda, kimlik bilgilerinizle ilişkili tüm Azure hesaplarınıza erişim izni elde edersiniz. Az account list komutunu kullanarak hesapların tam listesini görüntüleyin:
```
az account list
```
IoT hub'ınızı oluşturmak üzere komutları çalıştırmak için kullanmak istediğiniz aboneliği seçmek için aşağıdaki komutu kullanın. Önceki komutun çıkışında yer alan abonelik adını veya kimliği kullanabilirsiniz:
```
az account set --subscription {your subscription name or id}
```
Aşağıdaki komut dosya bildirimlerini etkinleştirir ve dosya bildirim özelliklerini varsayılan değerlerine ayarlar. (Dosya karşıya yükleme bildiriminin yaşam süresi bir saat, kilit süresi ise 60 saniye olarak ayarlanır.)
```
az iot hub device-twin update -n {iothub_name} \
    -d {device_id} --tags '{"country": "USA"}'
```

Bir json dosyasını içeri aktararak veya doğrudan girişe json ekleyerek karmaşık iç içe etiketler ekleyebilirsiniz:

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

Mevcut bir etikette komutunu kullanarak değeri güncelleştirin:

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

Aşağıdaki komut, değeri null olarak ayarlayarak eklenen etiketi kaldırır.

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

Not

PowerShell veya CloudShell PowerShell>modu kullanıyorsanız, tüm çift tırnaklardan kaçmak için eğik çizgi '\' eklemeniz gerekir. Örnek: --tags '{\"country\":\"US\"}'

Azure CLI kullanarak etiket ayarlamak için iş oluşturma

IoT Hub İşleri CLI'sına tam başvurular için

Sonraki adımlar

Artık cihaz ikizleri hakkında bilgi edindiniz, aşağıdaki IoT Hub geliştirici kılavuzu konuları ilginizi çekebilir:

Bu makalede açıklanan kavramlardan bazılarını denemek için aşağıdaki IoT Hub öğreticilerine bakın:

Aracılığıyla paylaş