Bagikan melalui

Menjadwalkan dan menyiarkan pekerjaan dengan Azure CLI

  • Artikel

Gunakan Azure CLI untuk menjadwalkan dan melacak pekerjaan yang memperbarui jutaan perangkat. Gunakan pekerjaan untuk:

  • Memperbarui properti yang diinginkan
  • Memperbarui tag
  • Memanggil metode langsung

Secara konseptual, pekerjaan membungkus salah satu tindakan ini dan melacak kemajuan eksekusi terhadap satu set perangkat. Kueri kembar perangkat menentukan kumpulan perangkat tempat pekerjaan berinteraksi. Misalnya, aplikasi backend dapat menggunakan pekerjaan untuk memanggil metode reboot pada 10.000 perangkat, yang ditentukan oleh kueri kembar perangkat dan dijadwalkan pada waktu mendatang. Aplikasi itu kemudian dapat melacak kemajuan saat masing-masing perangkat tersebut menerima dan menjalankan metode reboot.

Untuk mempelajari selengkapnya tentang bagaimana pekerjaan membantu mengelola operasi manajemen perangkat massal, lihat Menjadwalkan pekerjaan di beberapa perangkat.

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

  • Azure CLI. Anda juga dapat menjalankan perintah dalam artikel ini menggunakan Azure Cloud Shell, shell CLI interaktif yang berjalan di browser Anda atau di aplikasi seperti Terminal Windows. Jika menggunakan Cloud Shell, Anda tidak perlu memasang apa pun. Jika Anda lebih suka menggunakan CLI secara lokal, artikel ini memerlukan Azure CLI versi 2.36 atau yang lebih baru. Untuk menemukan versi yang terinstal, jalankan az --version. Untuk menginstal atau meningkatkan Azure CLI secara lokal, lihat Menginstal Azure CLI.

  • IoT Hub di langganan Azure Anda. Jika belum memiliki hub, Anda dapat mengikuti langkah-langkah di Membuat IoT hub.

Menjadwalkan pekerjaan untuk memanggil metode langsung

Anda dapat menggunakan pekerjaan untuk memanggil metode langsung pada satu atau beberapa perangkat.

Gunakan perintah az iot hub job create, mengganti tempat penampung berikut dengan nilai yang sesuai. Perintah menjadwalkan pekerjaan yang memanggil nama metode pada perangkat target.

az iot hub job create --hub-name {HubName} --job-id {JobName} \
                      --job-type scheduleDeviceMethod \
                      --method-name {MethodName} --method-payload {MethodPayload} \
                      --query-condition "{DeviceQuery}"
Placeholder Nilai
{HubName} Nama IoT hub.
{JobName} Nama pekerjaan terjadwal Anda. Nama pekerjaan unik, jadi pilih nama pekerjaan yang berbeda setiap kali Anda menjalankan perintah ini.
{MethodName} Nama metode langsung Anda.
{MethodPayload} Payload apa pun yang akan diberikan ke metode langsung. Jika tidak ada payload yang diperlukan, gunakan null.
{DeviceQuery} Kueri yang menentukan perangkat atau perangkat yang akan ditargetkan dengan pekerjaan. Misalnya, satu pekerjaan perangkat dapat menggunakan kondisi kueri berikut: deviceId = 'myExampleDevice'.

Tip

Saat menjadwalkan perintah az iot hub job create pekerjaan yang memanggil metode langsung, Anda harus menentukan nilai untuk --method-name parameter opsional dan --method-payload . Untuk metode langsung yang tidak menerima payload, tentukan null untuk --method-payload parameter .

Menjadwalkan pekerjaan untuk memperbarui properti kembar perangkat

Anda dapat menggunakan pekerjaan untuk memperbarui properti yang diinginkan kembar perangkat.

Gunakan perintah az iot hub job create, mengganti tempat penampung berikut dengan nilai yang sesuai. Dalam contoh ini, kami menjadwalkan pekerjaan untuk menetapkan nilai properti BuildingNo kembar yang diinginkan ke 45 untuk perangkat simulasi kami.

az iot hub job create --hub-name {HubName} --job-id {JobName} \
                      --job-type scheduleUpdateTwin \
                      --twin-patch '{JSONTwinPatch}' \
                      --query-condition "{DeviceQuery}"
Placeholder Nilai
{HubName} Nama IoT hub.
{JobName} Nama pekerjaan terjadwal Anda. Nama pekerjaan unik, jadi pilih nama pekerjaan yang berbeda setiap kali Anda menjalankan perintah ini.
{JSONTwinPatch} Cuplikan JSON yang ingin Anda gunakan untuk memperbarui properti yang diinginkan kembar perangkat. Contohnya,{"properties":{"desired": {"BuildingNo": 45}}}.
{DeviceQuery} Kueri yang menentukan perangkat atau perangkat yang akan ditargetkan dengan pekerjaan. Misalnya, satu pekerjaan perangkat dapat menggunakan kondisi kueri berikut: deviceId = 'myExampleDevice'.

Konten terkait

Pelajari cara menerapkan pekerjaan secara terprogram menggunakan Azure IoT SDK: Menjadwalkan dan menyiarkan pekerjaan.