Cara melihat dan memperbarui perangkat berdasarkan properti kembar perangkat
Gunakan portal Azure dan Azure CLI untuk mengelola perangkat melalui perangkat kembar dan modul kembar. Artikel ini berfokus pada perangkat kembar untuk kesederhanaan, tetapi semua konsep dan proses bekerja dengan cara yang sama untuk kembar modul.
Artikel ini menjelaskan tugas manajemen kembar perangkat yang tersedia di portal Azure atau Azure CLI untuk mengelola kembar perangkat dari jarak jauh. Untuk informasi tentang mengembangkan aplikasi perangkat untuk menangani perubahan kembar perangkat, lihat Mulai menggunakan perangkat kembar.
Di IoT Hub, perangkat kembar adalah dokumen JSON yang menyimpan informasi status. Setiap identitas perangkat secara otomatis dikaitkan dengan perangkat kembar saat dibuat. Aplikasi backend atau pengguna dapat memperbarui dua elemen kembar perangkat:
- Properti yang diinginkan: Properti yang diinginkan adalah setengah dari sekumpulan informasi status yang ditautkan. Aplikasi backend atau pengguna dapat memperbarui properti yang diinginkan pada kembar untuk mengomunikasikan perubahan status yang diinginkan, sementara perangkat dapat memperbarui properti yang dilaporkan untuk mengomunikasikan statusnya saat ini.
- Tag: Anda dapat menggunakan tag kembar perangkat untuk mengatur dan mengelola perangkat dalam solusi IoT Anda. Anda dapat mengatur tag untuk kategori yang bermakna, seperti jenis perangkat, lokasi, atau fungsi.
Untuk informasi selengkapnya, lihat Memahami dan menggunakan perangkat kembar di IoT Hub atau Memahami dan menggunakan modul kembar di IoT Hub.
Catatan
Fitur yang dijelaskan dalam artikel ini hanya tersedia di tingkat standar IoT Hub. Untuk informasi selengkapnya tentang tingkat IoT Hub dasar dan standar/gratis, lihat Memilih tingkat IoT Hub yang tepat untuk solusi Anda.
Prasyarat
Siapkan prasyarat berikut sebelum Anda mulai.
IoT Hub di langganan Azure Anda. Jika Anda belum memiliki hub, ikuti langkah-langkah di Membuat hub IoT.
Perangkat yang terdaftar di hub IoT Anda. Jika Anda tidak memiliki perangkat di hub IoT Anda, ikuti langkah-langkah di Mendaftarkan perangkat.
Memahami tag untuk organisasi perangkat
Tag kembar perangkat dapat digunakan sebagai alat yang kuat untuk membantu Anda mengatur perangkat Anda. Saat Anda memiliki beberapa jenis perangkat dalam solusi IoT, Anda dapat menggunakan tag untuk mengatur jenis, lokasi, dll. Misalnya:
{
"deviceId": "mydevice1",
"status": "enabled",
"connectionState": "Connected",
"cloudToDeviceMessageCount": 0,
"authenticationType": "sas",
"tags": {
"deploymentLocation": {
"building": "43",
"floor": "1"
},
"deviceType":"HDCamera"
},
"properties": {
...
}
}
Melihat dan memperbarui perangkat kembar
Setelah identitas perangkat dibuat, perangkat kembar secara implisit dibuat di IoT Hub. Anda dapat menggunakan portal Azure atau Azure CLI untuk mengambil perangkat kembar perangkat tertentu. Anda juga dapat menambahkan, mengedit, atau menghapus tag dan properti yang diinginkan.
Di portal Azure, navigasi ke hub IoT Anda.
Di hub IoT Anda, pilih Perangkat dari bagian Manajemen perangkat di menu navigasi.
Pada halaman Perangkat , Anda akan melihat daftar semua perangkat yang terdaftar di hub IoT Anda. Jika salah satu perangkat sudah memiliki tag di perangkat kembar mereka, tag tersebut ditampilkan di kolom Tag .
Pilih nama perangkat yang ingin Anda kelola.
Tip
Jika Memperbarui tag, Anda dapat memilih beberapa perangkat, lalu pilih Tetapkan tag untuk mengelolanya sebagai grup.
Halaman detail perangkat menampilkan tag saat ini untuk perangkat yang dipilih. Pilih edit di samping parameter Tag untuk menambahkan, memperbarui, atau menghapus tag.
Tip
Untuk menambahkan atau memperbarui tag berlapis, pilih tab Tingkat Lanjut dan berikan JSON.
Pilih Perangkat kembar untuk melihat dan memperbarui JSON kembar perangkat.
Anda dapat mengetik langsung di kotak teks untuk memperbarui tag atau properti yang diinginkan. Untuk menghapus tag atau properti yang diinginkan, atur nilai item ke
null
.Pilih Simpan untuk menerapkan perubahan.
Kembali ke halaman detail perangkat, pilih Refresh untuk memperbarui halaman untuk mencerminkan perubahan Anda.
Jika perangkat Anda memiliki identitas modul yang terkait dengannya, modul tersebut juga ditampilkan di halaman detail perangkat. Pilih nama modul, lalu pilih Module identity twin untuk melihat dan memperbarui modul kembar JSON.
Kueri untuk perangkat kembar
IoT Hub mengekspos perangkat kembar untuk hub IoT Anda sebagai koleksi dokumen yang disebut perangkat. Anda dapat mengkueri perangkat berdasarkan nilai kembar perangkatnya.
Bagian ini menjelaskan cara menjalankan kueri kembar di portal Azure dan Azure CLI. Untuk mempelajari cara menulis kueri kembar, lihat Kueri untuk perangkat IoT Hub dan modul kembar.
Di portal Azure, navigasi ke hub IoT Anda.
Di hub IoT Anda, pilih Perangkat dari bagian Manajemen perangkat di menu navigasi.
Anda dapat menggunakan filter atau kueri untuk menemukan perangkat berdasarkan detail kembar perangkat mereka:
Temukan perangkat menggunakan filter:
Menemukan perangkat menggunakan filter adalah tampilan default di portal Azure. Jika Anda tidak melihat bidang ini, pilih Temukan perangkat menggunakan filter.
Pilih Tambahkan filter, lalu pilih Tag perangkat sebagai jenis filter dari menu drop-down.
Masukkan nama dan nilai tag yang diinginkan, pilih Terapkan untuk mengambil daftar perangkat yang cocok dengan kriteria.
Temukan perangkat menggunakan kueri:
Pilih Temukan perangkat menggunakan kueri.
Masukkan kueri Anda ke dalam kotak teks, lalu pilih Jalankan kueri.
Memperbarui perangkat kembar menggunakan pekerjaan
Kemampuan pekerjaan dapat menjalankan pembaruan kembar perangkat terhadap sekumpulan perangkat pada waktu yang dijadwalkan. Untuk informasi selengkapnya, lihat Menjadwalkan pekerjaan di beberapa perangkat.
Pekerjaan tidak didukung di portal Azure. Sebagai gantinya, gunakan Azure CLI.