Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
AWS IoT Pekerjaan API dapat digunakan untuk salah satu dari kategori berikut:
-
Tugas administratif seperti manajemen dan kontrol pekerjaan. Ini adalah pesawat kontrol.
-
Perangkat yang melakukan pekerjaan tersebut. Ini adalah pesawat data, yang memungkinkan Anda mengirim dan menerima data.
Manajemen dan kontrol Job menggunakan HTTPS protokolAPI. Perangkat dapat menggunakan HTTPS protokol MQTT atau protokolAPI. Pesawat kontrol API 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 izin polling panjang. APIOperasi ini dirancang untuk sejumlah besar lalu lintas yang dapat menskalakan ke jutaan perangkat.
Setiap AWS IoT Jobs HTTPS API memiliki perintah yang sesuai yang memungkinkan Anda untuk memanggil API from AWS Command Line Interface (AWS CLI). Perintahnya huruf kecil, dengan tanda hubung di antara kata-kata yang membentuk nama. API Misalnya, Anda dapat memanggil CreateJob API on CLI dengan mengetik:
aws iot create-job ...
Jika terjadi kesalahan selama operasi, Anda mendapatkan respons kesalahan yang berisi informasi tentang kesalahan tersebut.
Berisi informasi tentang kesalahan yang terjadi selama operasi layanan AWS IoT Jobs.
Contoh berikut menunjukkan sintaks operasi ini:
{
"code": "ErrorCode",
"message": "string",
"clientToken": "string",
"timestamp": timestamp,
"executionState": JobExecutionState
}Berikut ini adalah deskripsi tentang iniErrorResponse:
code-
ErrorCode dapat diatur ke:
- InvalidTopic
-
Permintaan dikirim ke topik di namespace AWS IoT Jobs yang tidak dipetakan ke operasi apa punAPI.
- InvalidJson
-
Isi permintaan tidak dapat ditafsirkan sebagai UTF JSON -8 yang dikodekan yang valid.
- InvalidRequest
-
Isi permintaan tidak valid. Misalnya, kode ini dikembalikan ketika
UpdateJobExecutionpermintaan berisi detail status yang tidak valid. Pesan tersebut 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 status SUCCEEDED menjadi IN_PROGRESS. Dalam hal ini, isi pesan kesalahan juga berisi
executionStatebidang. - ResourceNotFound
-
Yang
JobExecutionditentukan oleh topik permintaan tidak ada. - VersionMismatch
-
Versi yang diharapkan yang ditentukan dalam permintaan tidak cocok dengan versi eksekusi pekerjaan di layanan AWS IoT Jobs. Dalam hal ini, isi pesan kesalahan juga berisi
executionStatebidang. - InternalError
-
Ada kesalahan internal selama pemrosesan permintaan.
- RequestThrottled
-
Permintaan itu dibatasi.
- TerminalStateReached
-
Terjadi ketika perintah untuk menggambarkan pekerjaan dilakukan pada pekerjaan yang berada dalam status terminal.
message-
String pesan kesalahan.
clientToken-
String arbitrer yang digunakan untuk mengkorelasikan permintaan dengan jawabannya.
timestamp-
Waktu, dalam hitungan detik sejak zaman.
executionState-
Sebuah objek
JobExecutionState. Bidang ini disertakan hanya jikacodebidang memiliki nilaiInvalidStateTransitionatauVersionMismatch. Hal ini membuatnya tidak perlu dalam kasus ini untuk melakukanDescribeJobExecutionpermintaan terpisah untuk mendapatkan data status eksekusi pekerjaan saat ini.
Berikut ini mencantumkan API operasi Jobs dan tipe data.
