Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menentukan konfigurasi pekerjaan dengan menggunakan AWS IoT Jobs API
Anda dapat menggunakan [CreateJob](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html)atau [CreateJobTemplate](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html)API untuk menentukan konfigurasi pekerjaan yang berbeda. Bagian berikut menjelaskan cara menambahkan konfigurasi ini. Setelah menambahkan konfigurasi, Anda dapat menggunakan [JobExecutionSummary](https://docs.aws.amazon.com/iot/latest/apireference/API_JobExecutionSummary.html)dan [JobExecutionSummaryForJob](https://docs.aws.amazon.com/iot/latest/apireference/API_JobExecutionSummaryForJob.html)melihat statusnya.
Untuk informasi selengkapnya tentang konfigurasi yang berbeda dan cara kerjanya, lihat[Cara kerja konfigurasi tugas](jobs-configurations-details.md).
## Konfigurasi peluncuran
Anda dapat menentukan tingkat peluncuran konstan atau tingkat peluncuran eksponensial untuk konfigurasi peluncuran Anda.
+
**Tetapkan tingkat peluncuran konstan**
Untuk menetapkan tingkat peluncuran konstan, gunakan [https://docs.aws.amazon.com/iot/latest/apireference/API_JobExecutionsRolloutConfig.html](https://docs.aws.amazon.com/iot/latest/apireference/API_JobExecutionsRolloutConfig.html)objek untuk menambahkan `maximumPerMinute` parameter ke permintaan. `CreateJob` Parameter ini menentukan batas atas tingkat di mana eksekusi pekerjaan dapat terjadi. Nilai ini opsional dan berkisar dari 1 hingga 1000. Jika Anda tidak menetapkan nilai, itu menggunakan 1000 sebagai nilai default.
```
"jobExecutionsRolloutConfig": {
"maximumPerMinute": 1000
}
```
+
**Tetapkan tingkat peluncuran eksponensial**
Untuk menetapkan tingkat peluncuran pekerjaan variabel, gunakan objek. [https://docs.aws.amazon.com/iot/latest/apireference/API_JobExecutionsRolloutConfig.html](https://docs.aws.amazon.com/iot/latest/apireference/API_JobExecutionsRolloutConfig.html) Anda dapat mengonfigurasi `ExponentialRolloutRate` properti saat menjalankan operasi `CreateJob` API. Contoh berikut menetapkan tingkat peluncuran eksponensial dengan menggunakan parameter. `exponentialRate` Untuk informasi tentang parameter, lihat [https://docs.aws.amazon.com/iot/latest/apireference/API_ExponentialRolloutRate.html](https://docs.aws.amazon.com/iot/latest/apireference/API_ExponentialRolloutRate.html).
```
{
...
"jobExecutionsRolloutConfig": {
"exponentialRate": {
"baseRatePerMinute": 50,
"incrementFactor": 2,
"rateIncreaseCriteria": {
"numberOfNotifiedThings": 1000,
"numberOfSucceededThings": 1000
},
"maximumPerMinute": 1000
}
}
...
}
```
Dimana parameternya:
**baseRatePerMenit**
Menentukan tingkat di mana pekerjaan dieksekusi sampai `numberOfSucceededThings` ambang batas `numberOfNotifiedThings` atau telah terpenuhi.
**IncrementFactor**
Menentukan faktor eksponensial dimana tingkat peluncuran meningkat setelah ambang batas `numberOfNotifiedThings` atau `numberOfSucceededThings` terpenuhi.
**rateIncreaseCriteria**
Menentukan baik `numberOfNotifiedThings` atau `numberOfSucceededThings` ambang batas.
## Batalkan konfigurasi
Untuk menambahkan konfigurasi ini dengan menggunakan API, tentukan [https://docs.aws.amazon.com/iot/latest/apireference/API_AbortConfig.html](https://docs.aws.amazon.com/iot/latest/apireference/API_AbortConfig.html)parameter saat Anda menjalankan [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html), atau operasi [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html)API. Contoh berikut menunjukkan konfigurasi abort untuk peluncuran pekerjaan yang mengalami beberapa eksekusi gagal, seperti yang ditentukan dengan operasi API. `CreateJob`
**catatan**
Menghapus eksekusi pekerjaan memengaruhi nilai komputasi dari total eksekusi yang diselesaikan. Ketika pekerjaan dibatalkan, layanan akan membuat pembatalan otomatis `comment` dan `reasonCode` untuk membedakan pembatalan yang digerakkan pengguna dari pembatalan pembatalan pekerjaan.
```
"abortConfig": {
"criteriaList": [
{
"action": "CANCEL",
"failureType": "FAILED",
"minNumberOfExecutedThings": 100,
"thresholdPercentage": 20
},
{
"action": "CANCEL",
"failureType": "TIMED_OUT",
"minNumberOfExecutedThings": 200,
"thresholdPercentage": 50
}
]
}
```
Dimana parameternya:
**aksi**
Menentukan tindakan yang harus diambil ketika kriteria abort telah dipenuhi. Parameter ini diperlukan, dan `CANCEL` merupakan satu-satunya nilai yang valid.
**FailureType**
Menentukan jenis kegagalan yang harus memulai pekerjaan abort. Nilai yang valid adalah `FAILED`, `REJECTED`, `TIMED_OUT`, dan `ALL`.
**minNumberOfExecutedThings**
Menentukan jumlah eksekusi pekerjaan selesai yang harus terjadi sebelum kriteria pembatalan pekerjaan telah dipenuhi. Dalam contoh ini, AWS IoT tidak memeriksa untuk melihat apakah pembatalan pekerjaan harus terjadi sampai setidaknya 100 perangkat telah menyelesaikan eksekusi pekerjaan.
**ThresholdPercentage**
Menentukan jumlah total hal-hal yang pekerjaan dijalankan yang dapat memulai pekerjaan abort. Dalam contoh ini, AWS IoT memeriksa secara berurutan dan memulai pembatalan pekerjaan jika persentase ambang terpenuhi. Jika setidaknya 20% dari eksekusi lengkap gagal setelah 100 eksekusi selesai, itu membatalkan peluncuran pekerjaan. Jika kriteria ini tidak terpenuhi, AWS IoT maka periksa apakah setidaknya 50% dari eksekusi selesai habis setelah 200 eksekusi selesai. Jika ini masalahnya, itu membatalkan peluncuran pekerjaan.
## Konfigurasi penjadwalan
Untuk menambahkan konfigurasi ini dengan menggunakan API, tentukan opsional [https://docs.aws.amazon.com/iot/latest/apireference/API_SchedulingConfig.html](https://docs.aws.amazon.com/iot/latest/apireference/API_SchedulingConfig.html)saat Anda menjalankan [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html), atau operasi [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html)API.
```
"SchedulingConfig": {
"endBehavior": string
"endTime": string
"maintenanceWindows": string
"startTime": string
}
```
Dimana parameternya:
**startTime**
Menentukan tanggal dan waktu ketika pekerjaan akan dimulai.
**EndTime**
Menentukan tanggal dan waktu ketika pekerjaan akan berakhir.
**PemeliharaanWindows**
Menentukan apakah jendela pemeliharaan opsional dipilih untuk pekerjaan terjadwal untuk meluncurkan dokumen pekerjaan ke semua perangkat dalam grup target. Format string untuk `maintenanceWindow` adalah YYYY/MM/DD untuk tanggal dan hh: mm untuk waktu.
**EndBehavior**
Menentukan perilaku pekerjaan untuk pekerjaan terjadwal setelah mencapai. `endTime`
**catatan**
Opsional `SchedulingConfig` untuk suatu pekerjaan dapat dilihat di [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html)dan [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJobTemplate.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJobTemplate.html) APIs.
## Konfigurasi waktu habis
Untuk menambahkan konfigurasi ini dengan menggunakan API, tentukan [https://docs.aws.amazon.com/iot/latest/apireference/API_TimeoutConfig.html](https://docs.aws.amazon.com/iot/latest/apireference/API_TimeoutConfig.html)parameter saat Anda menjalankan [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html), atau operasi [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html)API.
Untuk menggunakan konfigurasi batas waktu
1. Untuk mengatur timer yang sedang berlangsung saat Anda membuat templat pekerjaan atau pekerjaan, tetapkan nilai untuk `inProgressTimeoutInMinutes` properti [TimeoutConfig](https://docs.aws.amazon.com//iot/latest/apireference/API_TimeoutConfig.html)objek opsional.
```
"timeoutConfig": {
"inProgressTimeoutInMinutes": number
}
```
1. Untuk menentukan pengatur waktu langkah untuk eksekusi pekerjaan, tetapkan nilai `stepTimeoutInMinutes` saat Anda menelepon [UpdateJobExecution](https://docs.aws.amazon.com//iot/latest/apireference/API_iot-jobs-data_UpdateJobExecution.html). Pengatur waktu langkah hanya berlaku untuk eksekusi pekerjaan yang Anda perbarui. Anda dapat menetapkan nilai baru untuk timer ini setiap kali Anda memperbarui eksekusi pekerjaan.
**catatan**
`UpdateJobExecution`dapat membuang pengatur waktu langkah yang sudah dibuat dengan membuat pengatur waktu langkah baru dengan nilai -1.
```
{
...
"statusDetails": {
"string" : "string"
},
"stepTimeoutInMinutes": number
}
```
1. Untuk membuat pengatur waktu langkah baru, Anda juga dapat memanggil operasi [StartNextPendingJobExecution](https://docs.aws.amazon.com//iot/latest/apireference/API_iot-jobs-data_StartNextPendingJobExecution.html)API.
## Coba lagi konfigurasi
**catatan**
Saat Anda membuat pekerjaan, pertimbangkan jumlah percobaan ulang yang sesuai untuk digunakan untuk konfigurasi Anda. Untuk menghindari timbulnya biaya berlebih karena potensi kegagalan coba lagi, tambahkan konfigurasi batal. Setelah pekerjaan dibuat, jumlah percobaan ulang tidak dapat diperbarui. Anda hanya dapat mengatur jumlah percobaan ulang ke 0 dengan menggunakan operasi [UpdateJob](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateJob.html)API.
Untuk menambahkan konfigurasi ini dengan menggunakan API, tentukan [https://docs.aws.amazon.com/iot/latest/apireference/API_jobExecutionsRetryConfig.html](https://docs.aws.amazon.com/iot/latest/apireference/API_jobExecutionsRetryConfig.html)parameter saat Anda menjalankan [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html), atau operasi [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJobTemplate.html)API.
```
{
...
"jobExecutionsRetryConfig": {
"criteriaList": [
{
"failureType": "string",
"numberOfRetries": number
}
]
}
...
}
```
Di mana **Criterialist** adalah array yang menentukan daftar kriteria yang menentukan jumlah percobaan ulang yang diizinkan untuk setiap jenis kegagalan untuk pekerjaan.