Pekerjaan dan status eksekusi pekerjaan

Bagian berikut menjelaskan siklus hidup AWS IoT pekerjaan dan siklus hidup pelaksanaan pekerjaan.

Status Job

Diagram berikut menunjukkan keadaan AWS IoT pekerjaan yang berbeda.

Pekerjaan yang Anda buat menggunakan AWS IoT Jobs dapat berada di salah satu status berikut:

• SCHEDULED

  Selama pekerjaan awal atau pembuatan templat pekerjaan menggunakan AWS IoT konsol,, atau CreateJobAPICreateJobTemplateAPI, Anda dapat memilih konfigurasi penjadwalan opsional di AWS IoT konsol atau SchedulingConfig di CreateJobAPIatau CreateJobTemplateAPI. Saat Anda memulai pekerjaan terjadwal yang berisi status pekerjaan tertentu startTime endTimeendBehavoir, dan, pembaruan status pekerjaanSCHEDULED. Ketika pekerjaan mencapai yang Anda pilih startTime atau jendela pemeliharaan berikutnya (jika Anda memilih peluncuran pekerjaan selama jendela pemeliharaan), status akan diperbarui dari SCHEDULED ke IN_PROGRESS dan mulai peluncuran dokumen pekerjaan ke semua perangkat dalam grup target. startTime

• DI_ PROGRESS

  Saat Anda membuat pekerjaan menggunakan AWS IoT konsol atau CreateJobAPI, status pekerjaan akan diperbarui keIN_PROGRESS. Selama penciptaan lapangan kerja, AWS IoT Jobs mulai meluncurkan eksekusi pekerjaan ke perangkat di grup target Anda. Setelah semua eksekusi pekerjaan diluncurkan, AWS IoT Jobs menunggu perangkat untuk menyelesaikan tindakan jarak jauh.

  Untuk informasi tentang konkurensi dan batasan yang berlaku untuk pekerjaan yang sedang berlangsung, lihat. Batas Job

  catatan

  Ketika IN_PROGRESS pekerjaan mencapai akhir jendela pemeliharaan saat ini, peluncuran dokumen pekerjaan akan berhenti. Pekerjaan akan diperbarui SCHEDULED hingga jendela startTime pemeliharaan berikutnya.

• COMPLETED

  Pekerjaan berkelanjutan ditangani dengan salah satu cara berikut:

  • Untuk pekerjaan berkelanjutan tanpa konfigurasi penjadwalan opsional yang dipilih, selalu dalam proses dan terus berjalan untuk perangkat baru yang ditambahkan ke grup target. Itu tidak akan pernah mencapai status statusCOMPLETED.

  • Untuk pekerjaan berkelanjutan dengan konfigurasi penjadwalan opsional yang dipilih, berikut ini benar:

    • Jika endTime diberikan, pekerjaan berkelanjutan akan mencapai COMPLETED status ketika endTime telah berlalu dan semua eksekusi pekerjaan telah mencapai status status terminal.

    • Jika tidak disediakan dalam konfigurasi penjadwalan opsional, pekerjaan berkelanjutan akan terus melakukan peluncuran dokumen pekerjaan. endTime

  Untuk pekerjaan snapshot, status pekerjaan berubah menjadi COMPLETED saat semua eksekusi pekerjaannya memasuki status terminal, seperti,,SUCCEEDED, FAILED TIMED_OUTREMOVED, atau. CANCELED

• CANCELED

  Saat Anda membatalkan pekerjaan menggunakan AWS IoT konsol, CancelJobAPI, atauKonfigurasi pembatalan pekerjaan, status pekerjaan berubah menjadiCANCELED. Selama pembatalan pekerjaan, AWS IoT Jobs mulai membatalkan eksekusi pekerjaan yang dibuat sebelumnya.

  Untuk informasi tentang konkurensi dan batasan yang berlaku untuk pekerjaan yang dibatalkan, lihat. Batas Job

• DELETION_DI_ PROGRESS

  Saat Anda menghapus pekerjaan menggunakan AWS IoT konsol atau DeleteJobAPI, status pekerjaan akan berubah menjadiDELETION_IN_PROGRESS. Selama penghapusan pekerjaan, AWS IoT Jobs mulai menghapus eksekusi pekerjaan yang dibuat sebelumnya. Setelah semua eksekusi pekerjaan telah dihapus, pekerjaan menghilang dari AWS akun Anda.

Status eksekusi Job

Tabel berikut menunjukkan status yang berbeda dari eksekusi AWS IoT pekerjaan dan apakah perubahan status diprakarsai oleh perangkat atau oleh AWS IoT Jobs.

Status dan sumber eksekusi Job

Status eksekusi Job	Dimulai oleh perangkat?	Diprakarsai oleh AWS IoT Jobs?	Status terminal?	Bisa dicoba lagi?
QUEUED	Tidak	Ya	Tidak	Tidak berlaku
IN_PROGRESS	Ya	Tidak	Tidak	Tidak berlaku
SUCCEEDED	Ya	Tidak	Ya	Tidak berlaku
FAILED	Ya	Tidak	Ya	Ya
TIMED_OUT	Tidak	Ya	Ya	Ya
REJECTED	Ya	Tidak	Ya	Tidak
REMOVED	Tidak	Ya	Ya	Tidak
CANCELED	Tidak	Ya	Ya	Tidak

Bagian berikut menjelaskan lebih lanjut tentang status eksekusi pekerjaan yang diluncurkan saat Anda membuat pekerjaan dengan AWS IoT Jobs.

• QUEUED

  Saat AWS IoT Jobs meluncurkan eksekusi pekerjaan untuk perangkat target, status eksekusi pekerjaan disetel keQUEUED. Eksekusi pekerjaan tetap di QUEUED negara bagian sampai:

  • Perangkat Anda menerima eksekusi pekerjaan dan memanggil API operasi Pekerjaan dan melaporkan statusnya sebagaiIN_PROGRESS.

  • Anda membatalkan pelaksanaan pekerjaan atau pekerjaan, atau ketika kriteria pembatalan yang Anda tentukan terpenuhi, dan statusnya berubah menjadiCANCELED.

  • Perangkat Anda dihapus dari grup target dan statusnya berubah menjadiREMOVED.

  

• DI_ PROGRESS

  Jika perangkat IoT Anda berlangganan ke yang dicadangkan Topik Job $notify dan$notify-next, dan perangkat Anda memanggil salah satu StartNextPendingJobExecution API atau UpdateJobExecution API dengan statusIN_PROGRESS, AWS IoT Jobs akan menetapkan status eksekusi pekerjaan ke. IN_PROGRESS

  UpdateJobExecutionAPIDapat dipanggil beberapa kali dengan status. IN_PROGRESS Anda dapat menentukan detail tambahan tentang langkah-langkah eksekusi menggunakan statusDetails objek.

  catatan

  Jika Anda membuat beberapa pekerjaan untuk setiap perangkat, AWS IoT Jobs dan MQTT protokol tidak menjamin pesanan pengiriman.

• SUCCEEDED

  Ketika perangkat Anda berhasil menyelesaikan operasi jarak jauh, perangkat harus memanggil UpdateJobExecution API dengan status SUCCEEDED untuk menunjukkan bahwa eksekusi pekerjaan berhasil. AWS IoT Jobs kemudian memperbarui dan mengembalikan status eksekusi pekerjaan sebagaiSUCCEEDED.

  

• FAILED

  Ketika perangkat Anda gagal menyelesaikan operasi jarak jauh, perangkat harus memanggil UpdateJobExecution API dengan status Failed untuk menunjukkan bahwa eksekusi pekerjaan gagal. AWS IoT Jobs kemudian memperbarui dan mengembalikan status eksekusi pekerjaan sebagaiFailed. Anda dapat mencoba lagi eksekusi pekerjaan ini untuk perangkat menggunakan file. Konfigurasi coba lagi eksekusi Job

  

• TIMED_OUT

  Saat perangkat Anda gagal menyelesaikan langkah pekerjaan saat statusnyaIN_PROGRESS, atau saat gagal menyelesaikan operasi jarak jauh dalam durasi waktu tunggu pengatur waktu yang sedang berlangsung, AWS IoT Jobs akan menetapkan status eksekusi pekerjaan. TIMED_OUT Anda juga memiliki pengatur waktu langkah untuk setiap langkah pekerjaan dari pekerjaan yang sedang berlangsung dan hanya berlaku untuk pelaksanaan pekerjaan. Durasi pengatur waktu yang sedang berlangsung ditentukan menggunakan inProgressTimeoutInMinutes properti. Konfigurasi batas waktu eksekusi Job Anda dapat mencoba lagi eksekusi pekerjaan ini untuk perangkat menggunakan file. Konfigurasi coba lagi eksekusi Job

  

• REJECTED

  Ketika perangkat Anda menerima permintaan yang tidak valid atau tidak kompatibel, perangkat harus memanggil UpdateJobExecution API dengan status. REJECTED AWS IoT Jobs kemudian memperbarui dan mengembalikan status eksekusi pekerjaan sebagaiREJECTED.

• REMOVED

  Jika perangkat Anda tidak lagi menjadi target yang valid untuk eksekusi pekerjaan, seperti saat perangkat terlepas dari grup hal dinamis, AWS IoT Jobs akan menetapkan status eksekusi pekerjaan. REMOVED Anda dapat melampirkan kembali benda itu ke grup target Anda dan memulai ulang eksekusi pekerjaan untuk perangkat.

• CANCELED

  Ketika Anda membatalkan pekerjaan atau membatalkan eksekusi pekerjaan menggunakan konsol atau atau CancelJobExecutionAPI, CancelJob atau ketika kriteria pembatalan yang ditentukan menggunakan terpenuhi, AWS IoT Pekerjaan membatalkan pekerjaan dan menetapkan status eksekusi pekerjaan. Konfigurasi pembatalan pekerjaan CANCELED