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

# AWS IoT pekerjaan operasi API
<a name="jobs-api"></a>

AWS IoT Jobs 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 API protokol HTTPS. Perangkat dapat menggunakan MQTT atau API protokol HTTPS. API bidang kontrol 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. Bidang data HTTPS dan MQTT API memungkinkan polling panjang. Operasi API 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 dari AWS Command Line Interface (AWS CLI). Perintahnya huruf kecil, dengan tanda hubung di antara kata-kata yang membentuk nama API. Misalnya, Anda dapat menjalankan `CreateJob` API pada CLI dengan mengetik:

```
aws iot create-job ...
```

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

## ErrorResponse
<a name="jobs-mqtt-error-response"></a>

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 ini`ErrorResponse`:

`code`  
ErrorCode dapat diatur ke:    
InvalidTopic  
Permintaan dikirim ke topik di namespace AWS IoT Jobs yang tidak dipetakan 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 ketika `UpdateJobExecution` permintaan berisi detail status yang tidak valid. Pesan tersebut berisi detail tentang kesalahan tersebut.  
InvalidStateTransition  
Pembaruan mencoba mengubah eksekusi pekerjaan ke status yang tidak valid karena status eksekusi pekerjaan saat ini. Misalnya, upaya untuk mengubah permintaan dalam status BERHASIL untuk menyatakan IN\$1PROGRESS. Dalam hal ini, isi pesan kesalahan juga berisi `executionState` bidang.  
ResourceNotFound  
Yang `JobExecution` ditentukan 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 `executionState` bidang.  
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 [https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecutionState.html](https://docs.aws.amazon.com/iot/latest/apireference/API_iot-jobs-data_JobExecutionState.html). Bidang ini disertakan hanya jika `code` bidang memiliki nilai `InvalidStateTransition` atau`VersionMismatch`. Hal ini membuatnya tidak perlu dalam kasus ini untuk melakukan `DescribeJobExecution` permintaan terpisah untuk mendapatkan data status eksekusi pekerjaan saat ini.

**Topics**
+ [Manajemen pekerjaan dan kontrol API dan tipe data](jobs-management-control-api.md)
+ [Pekerjaan perangkat MQTT dan HTTPS API operasi dan tipe data](jobs-mqtt-https-api.md)