Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tentukan konfigurasi tambahan
Saat Anda membuat templat pekerjaan atau pekerjaan, Anda dapat menentukan konfigurasi tambahan ini. Berikut ini menunjukkan kapan Anda dapat menentukan konfigurasi ini.
+ Saat membuat template pekerjaan khusus. Pengaturan konfigurasi tambahan yang Anda tentukan akan disimpan saat Anda membuat pekerjaan dari template.
+ Saat membuat pekerjaan khusus dengan menggunakan file pekerjaan. File pekerjaan dapat berupa file JSON yang diunggah dalam bucket S3.
+ Saat membuat pekerjaan khusus dengan menggunakan template pekerjaan khusus. Jika templat sudah memiliki pengaturan ini yang ditentukan, Anda dapat menggunakannya kembali atau menggantinya dengan menentukan pengaturan konfigurasi baru.
+ Saat membuat pekerjaan khusus dengan menggunakan templat AWS terkelola.
**Topics**
+ [Tentukan konfigurasi pekerjaan dengan menggunakan Konsol Manajemen AWS](job-configurations-console.md)
+ [Menentukan konfigurasi pekerjaan dengan menggunakan AWS IoT Jobs API](job-configurations-api.md)
# Tentukan konfigurasi pekerjaan dengan menggunakan Konsol Manajemen AWS
Anda dapat menambahkan konfigurasi yang berbeda untuk pekerjaan Anda dengan menggunakan AWS IoT konsol. Setelah Anda membuat pekerjaan, Anda dapat melihat detail status konfigurasi pekerjaan Anda di halaman detail pekerjaan. Untuk informasi selengkapnya tentang konfigurasi yang berbeda dan cara kerjanya, lihat[Cara kerja konfigurasi tugas](jobs-configurations-details.md).
Tambahkan konfigurasi pekerjaan saat Anda membuat pekerjaan atau templat pekerjaan.
**Saat membuat template pekerjaan khusus**
Untuk menentukan konfigurasi peluncuran saat membuat template pekerjaan khusus
1. Buka [hub Job templates di AWS IoT konsol](https://console.aws.amazon.com/iot/home#/jobtemplatehub) dan pilih **Create job template**.
1. Tentukan properti template pekerjaan, berikan dokumen pekerjaan, perluas konfigurasi yang ingin Anda tambahkan, lalu tentukan parameter konfigurasi.
**Saat membuat pekerjaan khusus**
Untuk menentukan konfigurasi peluncuran saat membuat pekerjaan khusus
1. Buka [hub Job AWS IoT konsol](https://console.aws.amazon.com/iot/home#/jobhub) dan pilih **Create job**.
1. Pilih **Buat pekerjaan khusus** dan tentukan properti pekerjaan, target, dan apakah akan menggunakan file pekerjaan atau templat untuk dokumen pekerjaan. Anda dapat menggunakan templat khusus atau templat AWS terkelola.
1. Pilih konfigurasi pekerjaan dan kemudian perluas konfigurasi **Peluncuran untuk menentukan apakah akan menggunakan tingkat Konstan** **atau Tingkat** **eksponensial**. Kemudian, tentukan parameter konfigurasi.
Bagian selanjutnya menunjukkan parameter yang dapat Anda tentukan untuk setiap konfigurasi.
## Konfigurasi peluncuran
Anda dapat menentukan apakah akan menggunakan tingkat peluncuran konstan atau tingkat eksponensial.
+
**Tetapkan tingkat peluncuran konstan**
Untuk menetapkan tingkat konstan untuk eksekusi pekerjaan, pilih **Tingkat konstan**, lalu tentukan **Maksimum per menit** untuk batas atas tarif. Nilai ini opsional dan berkisar dari 1 hingga 1000. Jika Anda tidak mengaturnya, ia menggunakan 1000 sebagai nilai default.
+
**Tetapkan tingkat peluncuran eksponensial**
Untuk menetapkan laju eksponensial, pilih Tingkat **eksponensial dan kemudian tentukan parameter** ini:
+
**Tarif dasar per menit**
Tingkat di mana pekerjaan dijalankan hingga **Jumlah perangkat yang diberitahukan atau ambang batas Jumlah perangkat** **yang berhasil terpenuhi** untuk kriteria **kenaikan tarif**.
+
**Faktor kenaikan**
**Faktor eksponensial dimana tingkat peluncuran meningkat setelah Jumlah perangkat yang **diberitahukan atau ambang batas Jumlah perangkat** yang **berhasil terpenuhi** untuk kriteria kenaikan tarif.**
+
**Kriteria kenaikan tarif**
Ambang batas untuk **Jumlah perangkat yang diberitahukan atau Jumlah perangkat** **yang berhasil.**
## Batalkan konfigurasi
Pilih **Tambahkan konfigurasi baru** dan tentukan parameter berikut untuk setiap konfigurasi:
+
**Jenis kegagalan**
Menentukan jenis kegagalan yang memulai pekerjaan abort. **Ini termasuk **GAGAL, **DITOLAK****, **TIMED\$1OUT**, atau SEMUA.**
+
**Faktor kenaikan**
Menentukan jumlah eksekusi pekerjaan selesai yang harus terjadi sebelum kriteria pembatalan pekerjaan telah dipenuhi.
+
**Persentase ambang**
Menentukan jumlah total hal-hal yang dieksekusi yang memulai pekerjaan abort.
## Konfigurasi penjadwalan
Setiap pekerjaan dapat dimulai segera setelah pembuatan awal, dijadwalkan untuk dimulai di kemudian hari dan waktu, atau berlangsung selama jendela pemeliharaan berulang.
Pilih **Tambahkan konfigurasi baru** dan tentukan parameter berikut untuk setiap konfigurasi:
+
**Job dimulai**
Tentukan tanggal dan waktu kapan pekerjaan akan dimulai.
+
**Jendela pemeliharaan berulang**
Jendela pemeliharaan berulang menentukan tanggal dan waktu tertentu pekerjaan dapat menyebarkan dokumen pekerjaan ke perangkat target dalam pekerjaan. Jendela pemeliharaan dapat diulang setiap hari, mingguan, bulanan, atau pengulangan hari dan waktu khusus.
+
**Job berakhir**
Tentukan tanggal dan waktu kapan pekerjaan akan berakhir.
+
**Perilaku akhir pekerjaan**
Pilih perilaku akhir untuk semua eksekusi pekerjaan yang belum selesai saat pekerjaan selesai.
**catatan**
Ketika pekerjaan dengan konfigurasi penjadwalan opsional dan waktu akhir yang dipilih mencapai waktu akhir, pekerjaan menghentikan peluncuran ke semua perangkat yang tersisa di grup target. Ini juga memanfaatkan perilaku akhir yang dipilih tentang cara melanjutkan eksekusi pekerjaan yang tersisa dan upaya coba lagi mereka per konfigurasi coba lagi.
## Konfigurasi waktu habis
Secara default, tidak ada batas waktu dan pekerjaan Anda dibatalkan atau dihapus. Untuk menggunakan batas waktu, pilih **Aktifkan batas waktu**, lalu tentukan nilai batas waktu antara 1 menit dan 7 hari.
## Coba lagi konfigurasi
**catatan**
Setelah pekerjaan dibuat, jumlah percobaan ulang tidak dapat diperbarui. Anda hanya dapat menghapus konfigurasi coba lagi untuk semua jenis kegagalan. 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.
Pilih **Tambahkan konfigurasi baru** dan tentukan parameter berikut untuk setiap konfigurasi:
+
**Jenis kegagalan**
Menentukan jenis kegagalan yang harus memicu percobaan ulang eksekusi pekerjaan. Ini termasuk **Gagal**, **Timeout**, dan **Semua**.
+
**Jumlah percobaan**
Menentukan jumlah percobaan ulang untuk jenis **Kegagalan** yang dipilih. Untuk kedua jenis kegagalan yang digabungkan, hingga 10 percobaan ulang dapat dicoba.
# 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.