Jobs - Create Scheduled Job

Layanan:
IoT Hub
Versi API:
2021-04-12

Membuat pekerjaan baru untuk menjadwalkan pembaruan kembar atau metode langsung pada IoT Hub pada waktu yang dijadwalkan. Lihat https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs untuk informasi lebih lanjut.

PUT https://fully-qualified-iothubname.azure-devices.net/jobs/v2/{id}?api-version=2021-04-12

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
id
 path True

string

Pengidentifikasi unik pekerjaan.
api-version
 query True

string

Versi Api.

Isi Permintaan

Nama Jenis Deskripsi
cloudToDeviceMethod

CloudToDeviceMethod

Jenis metode dan parameter. Ini diperlukan jika jenis pekerjaan adalah cloudToDeviceMethod.
jobId

string

Pengidentifikasi unik pekerjaan.
maxExecutionTimeInSeconds

integer (int64)

Waktu eksekusi maksimum dalam secound.
queryCondition

string

Kondisi bagi perangkat untuk menjalankan pekerjaan. Ini diperlukan jika jenis pekerjaan adalah updateTwin atau cloudToDeviceMethod.
startTime

string (date-time)

Tanggal dan waktu mulai pekerjaan dalam standar ISO 8601.
type enum:
  • unknown
  • export
  • import
  • backup
  • readDeviceProperties
  • writeDeviceProperties
  • updateDeviceConfiguration
  • rebootDevice
  • factoryResetDevice
  • firmwareUpdate
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • restoreFromBackup
  • failoverDataCopy

Jenis pekerjaan.
updateTwin

Twin

Informasi status untuk perangkat atau modul. Ini secara implisit dibuat dan dihapus saat identitas perangkat/modul yang sesuai dibuat atau dihapus di IoT Hub.

Respons

Nama Jenis Deskripsi
200 OK

JobResponse

OKE.

Definisi

Nama Deskripsi
CloudToDeviceMethod

Parameter untuk menjalankan metode langsung pada perangkat.
DeviceCapabilities

Status kemampuan yang diaktifkan pada perangkat.
DeviceJobStatistics

Statistik pekerjaan mengenai status eksekusi.
JobRequest
JobResponse
Twin

Informasi status untuk perangkat atau modul. Ini secara implisit dibuat dan dihapus saat identitas perangkat/modul yang sesuai dibuat atau dihapus di IoT Hub.
TwinProperties

Properti kembar yang diinginkan dan dilaporkan. Kedalaman maksimum objek adalah 10.
X509Thumbprint

CloudToDeviceMethod

Objek

Parameter untuk menjalankan metode langsung pada perangkat.

Nama Jenis Deskripsi
connectTimeoutInSeconds

integer (int32)

methodName

string

Nama metode yang akan dijalankan.
payload

object

Payload metode langsung berformat JSON, berukuran hingga 128kb.
responseTimeoutInSeconds

integer (int32)

DeviceCapabilities

Objek

Status kemampuan yang diaktifkan pada perangkat.

Nama Jenis Deskripsi
iotEdge

boolean

Properti yang menentukan apakah perangkat adalah perangkat edge atau tidak.

DeviceJobStatistics

Objek

Statistik pekerjaan mengenai status eksekusi.

Nama Jenis Deskripsi
deviceCount

integer (int32)

Jumlah perangkat yang ditargetkan oleh pekerjaan.
failedCount

integer (int32)

Jumlah pekerjaan yang gagal.
pendingCount

integer (int32)

Jumlah pekerjaan yang tertunda (terjadwal).
runningCount

integer (int32)

Jumlah pekerjaan yang sedang berjalan.
succeededCount

integer (int32)

Jumlah pekerjaan yang berhasil.

JobRequest

Objek
Nama Jenis Deskripsi
cloudToDeviceMethod

CloudToDeviceMethod

Jenis metode dan parameter. Ini diperlukan jika jenis pekerjaan adalah cloudToDeviceMethod.
jobId

string

Pengidentifikasi unik pekerjaan.
maxExecutionTimeInSeconds

integer (int64)

Waktu eksekusi maksimum dalam secound.
queryCondition

string

Kondisi bagi perangkat untuk menjalankan pekerjaan. Ini diperlukan jika jenis pekerjaan adalah updateTwin atau cloudToDeviceMethod.
startTime

string (date-time)

Tanggal dan waktu mulai pekerjaan dalam standar ISO 8601.
type enum:
  • backup
  • export
  • factoryResetDevice
  • failoverDataCopy
  • firmwareUpdate
  • import
  • readDeviceProperties
  • rebootDevice
  • restoreFromBackup
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • unknown
  • updateDeviceConfiguration
  • writeDeviceProperties

Jenis pekerjaan.
updateTwin

Twin

Informasi status untuk perangkat atau modul. Ini secara implisit dibuat dan dihapus saat identitas perangkat/modul yang sesuai dibuat atau dihapus di IoT Hub.

JobResponse

Objek
Nama Jenis Deskripsi
cloudToDeviceMethod

CloudToDeviceMethod

Jenis metode dan parameter. Ini diperlukan jika jenis pekerjaan adalah cloudToDeviceMethod.
createdTime

string (date-time)

Sistem yang dihasilkan. Diabaikan saat pembuatan. Tanggal dan waktu pembuatan pekerjaan.
deviceJobStatistics

DeviceJobStatistics

Detail mengenai status eksekusi pekerjaan.
endTime

string (date-time)

Sistem yang dihasilkan. Diabaikan saat pembuatan. Tanggal dan waktu akhir pekerjaan di UTC.
failureReason

string

Alasan kegagalan, jika kegagalan terjadi.
jobId

string

Sistem yang dihasilkan. Diabaikan saat pembuatan. Pengidentifikasi unik pekerjaan.
maxExecutionTimeInSeconds

integer (int64)

Waktu eksekusi maksimum dalam secound.
queryCondition

string

Kondisi kueri perangkat.
startTime

string (date-time)

Tanggal dan waktu mulai pekerjaan terjadwal di UTC.
status enum:
  • cancelled
  • completed
  • enqueued
  • failed
  • queued
  • running
  • scheduled
  • unknown

Sistem yang dihasilkan. Diabaikan saat pembuatan. Status pekerjaan.
statusMessage

string

Pesan status pekerjaan.
type enum:
  • backup
  • export
  • factoryResetDevice
  • failoverDataCopy
  • firmwareUpdate
  • import
  • readDeviceProperties
  • rebootDevice
  • restoreFromBackup
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • unknown
  • updateDeviceConfiguration
  • writeDeviceProperties

Jenis pekerjaan.
updateTwin

Twin

Informasi status untuk perangkat atau modul. Ini secara implisit dibuat dan dihapus saat identitas perangkat/modul yang sesuai dibuat atau dihapus di IoT Hub.

Twin

Objek

Informasi status untuk perangkat atau modul. Ini secara implisit dibuat dan dihapus saat identitas perangkat/modul yang sesuai dibuat atau dihapus di IoT Hub.

Nama Jenis Deskripsi
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

Jenis autentikasi yang digunakan oleh perangkat.
capabilities

DeviceCapabilities

Status kemampuan yang diaktifkan pada perangkat.
cloudToDeviceMessageCount

integer (int32)

Jumlah pesan cloud-ke-perangkat yang dikirim.
connectionState enum:
  • Connected
  • Disconnected

Status koneksi perangkat.
deviceEtag

string

String yang mewakili ETag untuk perangkat, sesuai RFC7232.
deviceId

string

Pengidentifikasi unik perangkat dalam registri identitas IoT Hub. Ini adalah string peka huruf besar/kecil (panjang hingga 128 karakter) karakter alfanumerik ASCII 7-bit, dan karakter khusus berikut {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', '''}.
deviceScope

string

Cakupan perangkat.
etag

string

String yang mewakili ETag untuk perangkat kembar, sesuai RFC7232.
lastActivityTime

string (date-time)

Tanggal dan waktu saat perangkat terakhir tersambung atau menerima atau mengirim pesan. Tanggal dan waktu dipisahkan dalam format tanggalwaktu ISO8601 dalam UTC, misalnya, 2015-01-28T16:24:48.789Z. Nilai ini tidak diperbarui jika perangkat menggunakan protokol HTTP/1 untuk melakukan operasi olahpesan.
moduleId

string

Pengidentifikasi unik modul dalam registri identitas IoT Hub. Ini adalah string peka huruf besar/kecil (panjang hingga 128 karakter) karakter alfanumerik ASCII 7-bit, dan karakter khusus berikut {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', '''}.
parentScopes

string[]

Cakupan perangkat tepi tingkat atas jika berlaku. Hanya tersedia untuk perangkat edge.
properties

TwinProperties

Properti kembar yang diinginkan dan dilaporkan.
status enum:
  • disabled
  • enabled

Status perangkat yang diaktifkan. Jika dinonaktifkan, perangkat tidak dapat tersambung ke layanan.
statusReason

string

Alasan untuk status perangkat saat ini, jika ada.
statusUpdateTime

string (date-time)

Tanggal dan waktu saat status perangkat terakhir diperbarui.
tags

object

Kumpulan pasangan kunci-nilai dibaca dan ditulis oleh back end solusi. Mereka tidak terlihat oleh aplikasi perangkat. Kuncinya adalah UTF-8 yang dikodekan, peka huruf besar/kecil, dan panjangnya up-to 1KB. Karakter yang diizinkan mengecualikan karakter kontrol UNICODE (segmen C0 dan C1), '.', '$' dan spasi. Nilainya adalah objek JSON, panjangnya up-to 4KB.
version

integer (int64)

Versi untuk perangkat ganda termasuk tag dan properti yang diinginkan
x509Thumbprint

X509Thumbprint

Thumbprint X509 perangkat.

TwinProperties

Objek

Properti kembar yang diinginkan dan dilaporkan. Kedalaman maksimum objek adalah 10.

Nama Jenis Deskripsi
desired

object

Kumpulan pasangan kunci-nilai properti yang diinginkan. Kuncinya adalah UTF-8 yang dikodekan, peka huruf besar/kecil, dan panjangnya up-to 1KB. Karakter yang diizinkan mengecualikan karakter kontrol UNICODE (segmen C0 dan C1), '.', '$' dan spasi. Nilai porperty yang diinginkan adalah objek JSON, panjangnya up-to 4KB.
reported

object

Kumpulan pasangan kunci-nilai properti yang dilaporkan. Kuncinya adalah UTF-8 yang dikodekan, peka huruf besar/kecil, dan panjangnya up-to 1KB. Karakter yang diizinkan mengecualikan karakter kontrol UNICODE (segmen C0 dan C1), '.', '$' dan spasi. Nilai properti yang dilaporkan adalah objek JSON, panjangnya up-to 4KB.

X509Thumbprint

Objek
Nama Jenis Deskripsi
primaryThumbprint

string

Thumbprint utama sertifikat klien X509.
secondaryThumbprint

string

Thumbprint sekunder sertifikat klien X509.