AWS IoTpekerjaan API operations - AWS IoT Core

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS IoTpekerjaan API operations

AWS IoTJobs API dapat digunakan untuk salah satu dari kategori berikut:

  • Tugas administratif seperti manajemen dan pengendalian pekerjaan. Ini adalahpesawat kontrol.

  • Perangkat yang melakukan pekerjaan itu. Ini adalahpesawat data, yang memungkinkan Anda untuk mengirim dan menerima data.

Manajemen dan kontrol pekerjaan menggunakan API protokol HTTPS. Perangkat dapat menggunakan MQTT atau API protokol HTTPS. API control plane dirancang untuk volume panggilan rendah yang khas saat membuat dan melacak pekerjaan. Biasanya membuka koneksi untuk satu permintaan, dan kemudian menutup koneksi setelah respons diterima. Pesawat data HTTPS dan MQTT API mengizinkan polling panjang. Operasi API ini dirancang untuk lalu lintas dalam jumlah besar yang dapat menskalakan jutaan perangkat.

Masing-masingAWS IoTJobs HTTPS API memiliki perintah yang sesuai yang memungkinkan Anda untuk memanggil API dariAWS Command Line Interface(AWS CLI). Perintahnya adalah huruf kecil, dengan tanda hubung antara kata-kata yang membentuk nama API. Misalnya, Anda dapat memanggilCreateJobAPI pada CLI dengan mengetik:

aws iot create-job ...

Jika terjadi kesalahan selama operasi, Anda mendapatkan respons kesalahan yang berisi informasi tentang kesalahan.

Berisi informasi tentang kesalahan yang terjadi selamaAWS IoTJobs operasi layanan.

Contoh berikut menunjukkan sintaks operasi ini:

{
    "code": "ErrorCode",
    "message": "string",
    "clientToken": "string",
    "timestamp": timestamp,
    "executionState": JobExecutionState
}

Berikut ini adalah uraian tentang iniErrorResponse:

code

ErrorCodedapat diatur ke:

InvalidTopic

Permintaan dikirim ke topik diAWS IoTNamespace pekerjaan yang tidak memetakan ke operasi API apa pun.

InvalidJson

Isi permintaan tidak dapat ditafsirkan sebagai JSON yang dikodekan UTF-8 yang valid.

InvalidRequest

Isi permintaan tidak valid. Misalnya, kode ini dikembalikan ketikaUpdateJobExecutionpermintaan berisi rincian status tidak valid. Pesan berisi rincian tentang kesalahan.

InvalidStateTransition

Pembaruan mencoba mengubah eksekusi pekerjaan ke status yang tidak valid karena status eksekusi pekerjaan saat ini. Misalnya, upaya untuk mengubah permintaan dalam keadaan SUCCEEDED untuk menyatakan IN_PROGRESS. Dalam hal ini, isi pesan kesalahan juga berisiexecutionStatebidang.

ResourceNotFound

YangJobExecutionditentukan oleh topik permintaan tidak ada.

VersionMismatch

Versi yang diharapkan ditentukan dalam permintaan tidak cocok dengan versi eksekusi pekerjaan diAWS IoTJobs layanan. Dalam hal ini, isi pesan kesalahan juga berisiexecutionStatebidang.

InternalError

Ada kesalahan internal selama pemrosesan permintaan.

RequestThrottled

Permintaan itu dibatasi.

TerminalStateReached

Terjadi ketika perintah untuk menggambarkan pekerjaan dilakukan pada pekerjaan yang dalam keadaan terminal.

message

String pesan kesalahan.

clientToken

String sewenang-wenang yang digunakan untuk mengkorelasikan permintaan dengan jawabannya.

timestamp

Waktunya, dalam hitungan detik sejak zaman.

executionState

Sebuah objek JobExecutionState. Bidang ini disertakan hanya ketikacodebidang memiliki nilaiInvalidStateTransitionatauVersionMismatch. Hal ini membuatnya tidak perlu dalam kasus ini untuk melakukanDescribeJobExecutionpermintaan untuk mendapatkan data status eksekusi pekerjaan saat ini.

Berikut ini mencantumkan operasi Jobs API dan tipe data.