Cihaz ikizi özelliklerine göre cihazları görüntüleme ve güncelleştirme
Cihazları cihaz ikizleri ve modül ikizleri aracılığıyla yönetmek için Azure portalını ve Azure CLI'yi kullanın. Bu makale basitlik açısından cihaz ikizlerine odaklanır, ancak tüm kavramlar ve süreçler modül ikizleri için benzer şekilde çalışır.
Bu makalede, cihaz ikizlerini uzaktan yönetmek için Azure portalında veya Azure CLI'de kullanılabilen cihaz ikizi yönetim görevleri açıklanmaktadır. Cihaz ikizi değişikliklerini işlemek için cihaz uygulamaları geliştirme hakkında bilgi için bkz . Cihaz ikizlerini kullanmaya başlama.
IoT Hub'da cihaz ikizi, durum bilgilerini depolayan bir JSON belgesidir. Her cihaz kimliği , oluşturulduğunda bir cihaz ikizi ile otomatik olarak ilişkilendirilir. Arka uç uygulaması veya kullanıcı bir cihaz ikizinin iki öğesini güncelleştirebilir:
- İstenen özellikler: İstenen özellikler, bağlı durum bilgileri kümesinin yarısıdır. Bir arka uç uygulaması veya kullanıcı, istenen durum değişikliğini iletmek için bir ikizde istenen özellikleri güncelleştirebilirken, cihaz da bildirilen özellikleri güncel durumunu iletecek şekilde güncelleştirebilir.
- Etiketler: IoT çözümlerinizdeki cihazları düzenlemek ve yönetmek için cihaz ikizi etiketlerini kullanabilirsiniz. Cihaz türü, konum veya işlev gibi herhangi bir anlamlı kategori için etiketler ayarlayabilirsiniz.
Daha fazla bilgi için bkz. IoT Hub'da cihaz ikizlerini anlama ve kullanma veya IoT Hub'da modül ikizlerini anlama ve kullanma.
Not
Bu makalede açıklanan özellikler yalnızca IoT Hub'ın standart katmanında kullanılabilir. Temel ve standart/ücretsiz IoT Hub katmanları hakkında daha fazla bilgi için bkz. Çözümünüz için doğru IoT Hub katmanını seçme.
Önkoşullar
Başlamadan önce aşağıdaki önkoşulları hazırlayın.
Azure aboneliğinizde bir IoT hub'ı. Henüz bir hub'ına sahip değilseniz IoT hub'ı oluşturma makalesindeki adımları izleyin.
IoT hub'ınıza kayıtlı bir cihaz. IoT hub'ınızda bir cihaz yoksa Cihazı kaydetme bölümünde yer alan adımları izleyin.
Cihaz kuruluşunun etiketlerini anlama
Cihaz ikizi etiketleri, cihazlarınızı düzenlemenize yardımcı olmak için güçlü bir araç olarak kullanılabilir. IoT çözümlerinizde birden çok cihaz türü olduğunda, türleri, konumları vb. ayarlamak için etiketleri kullanabilirsiniz. Mesela:
{
"deviceId": "mydevice1",
"status": "enabled",
"connectionState": "Connected",
"cloudToDeviceMessageCount": 0,
"authenticationType": "sas",
"tags": {
"deploymentLocation": {
"building": "43",
"floor": "1"
},
"deviceType":"HDCamera"
},
"properties": {
...
}
}
Cihaz ikizlerini görüntüleme ve güncelleştirme
Cihaz kimliği oluşturulduktan sonra IoT Hub'da örtülü olarak bir cihaz ikizi oluşturulur. Belirli bir cihazın cihaz ikizini almak için Azure portalını veya Azure CLI'yi kullanabilirsiniz. Ayrıca etiketleri ve istenen özellikleri ekleyebilir, düzenleyebilir veya kaldırabilirsiniz.
Azure portalında IoT hub'ınıza gidin.
IoT hub'ınızda, gezinti menüsünün Cihaz yönetimi bölümünden Cihazlar'ı seçin.
Cihazlar sayfasında, IoT hub'ınıza kayıtlı tüm cihazların listesini görürsünüz. Cihazlardan herhangi birinin cihaz ikizlerinde zaten etiketleri varsa, bu etiketler Etiketler sütununda gösterilir.
Yönetmek istediğiniz cihazın adını seçin.
İpucu
Etiketleri güncelleştiriyorsanız, birden çok cihaz seçebilir ve ardından Etiketleri ata'yı seçerek bunları grup olarak yönetebilirsiniz.
Cihaz ayrıntıları sayfasında seçili cihaz için geçerli etiketler görüntülenir. Etiketleri eklemek, güncelleştirmek veya kaldırmak için Etiketler parametresinin yanındaki Düzenle'yi seçin.
İpucu
İç içe etiketleri eklemek veya güncelleştirmek için Gelişmiş sekmesini seçin ve JSON'yi sağlayın.
Cihaz ikizi JSON'unu görüntülemek ve güncelleştirmek için Cihaz ikizi'ni seçin.
Etiketleri veya istenen özellikleri güncelleştirmek için doğrudan metin kutusuna yazabilirsiniz. Bir etiketi veya istenen özelliği kaldırmak için öğenin değerini olarak
nullayarlayın.Yaptığınız değişiklikleri kaydetmek için Kaydet'i seçin.
Cihaz ayrıntıları sayfasına dönüp Yenile'yi seçerek sayfayı değişikliklerinizi yansıtacak şekilde güncelleştirin.
Cihazınızda kendisiyle ilişkilendirilmiş modül kimlikleri varsa, bu modüller cihaz ayrıntıları sayfasında da görüntülenir. Modül adını seçin, ardından modül ikizi JSON'unu görüntülemek ve güncelleştirmek için Modül kimlik ikizini seçin.
Cihaz ikizleri için sorgu
IoT Hub, IoT hub'ınız için cihaz ikizlerini cihazlar adlı bir belge koleksiyonu olarak kullanıma sunar. Cihazları cihaz ikizi değerlerine göre sorgulayabilirsiniz.
Bu bölümde Azure portalında ve Azure CLI'da ikiz sorgularının nasıl çalıştırıldığı açıklanmaktadır. İkiz sorguları yazmayı öğrenmek için bkz . IoT Hub cihazı ve modül ikizleri için sorgular.
Azure portalında IoT hub'ınıza gidin.
IoT hub'ınızda, gezinti menüsünün Cihaz yönetimi bölümünden Cihazlar'ı seçin.
Cihaz ikizi ayrıntılarına göre cihazları bulmak için bir filtre veya sorgu kullanabilirsiniz:
Filtre kullanarak cihazları bulma:
Filtre kullanarak cihazları bulmak, Azure portalında varsayılan görünümdür. Bu alanları görmüyorsanız Filtre kullanarak cihazları bul'u seçin.
Filtre ekle'yi seçin ve ardından açılan menüden filtre türü olarak Cihaz etiketi'ni seçin.
İstediğiniz etiket adını ve değerini girin, ölçütlere uyan cihazların listesini almak için Uygula'yı seçin.
Sorgu kullanarak cihazları bulma:
Sorgu kullanarak cihazları bul'u seçin.
Metin kutusuna sorgunuzu girin, ardından Sorguyu çalıştır'ı seçin.
İşleri kullanarak cihaz ikizlerini güncelleştirme
İşler özelliği, cihaz ikizi güncelleştirmelerini zamanlanmış bir zamanda bir dizi cihazda yürütebilir. Daha fazla bilgi için bkz . Birden çok cihazda iş zamanlama.
İşler Azure portalında desteklenmez. Bunun yerine Azure CLI'yi kullanın.