View a markdown version of this page

CancelJob - Amazon Location Service
Kasus penggunaanPahami permintaannyaPahami responsnya

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

CancelJob

CancelJobOperasi menghentikan pekerjaan yang berjalan atau tertunda. Hanya pekerjaan di status Tertunda atau Berjalan yang dapat dibatalkan. Pembatalan bersifat asinkron, jadi Anda harus memantau status pekerjaan untuk mengonfirmasi penyelesaian. Pekerjaan yang dibatalkan mungkin memiliki hasil sebagian di lokasi output tergantung pada kapan pembatalan terjadi selama pemrosesan.

Untuk informasi selengkapnya, lihat CancelJobdi Referensi API Amazon Location Service.

Misalnya permintaan, tanggapan, dan perintah CLI untuk API ini, lihat Cara membatalkan pekerjaan.

Kasus penggunaan

  • Hentikan pemrosesan yang tidak perlu: Batalkan pekerjaan yang diajukan dengan konfigurasi yang salah, tidak lagi diperlukan karena persyaratan bisnis yang berubah, atau dimulai secara tidak sengaja. Ini dapat mencegah sumber daya yang terbuang dan biaya yang tidak perlu.

  • Optimalisasi sumber daya dan biaya: Bebaskan kapasitas pemrosesan dengan membatalkan pekerjaan dengan prioritas lebih rendah ketika tugas dengan prioritas lebih tinggi perlu diproses.

Pahami permintaannya

CancelJobPermintaan hanya membutuhkan satu parameter untuk mengidentifikasi pekerjaan mana yang akan dibatalkan. Struktur permintaan sederhana ini memudahkan untuk menghentikan pemrosesan untuk pekerjaan yang tidak lagi diperlukan.

Permintaan tersebut mencakup parameter berikut:

Identifikasi Job

Parameter yang diperlukan yang menentukan pekerjaan mana yang akan dibatalkan.

  • JobId: Pengenal unik dari pekerjaan yang akan dibatalkan. Harus 1-100 karakter pola [-._\w]+ pencocokan. Ini adalah pengenal yang sama yang dikembalikan oleh StartJob operasi saat pekerjaan dibuat. Hanya pekerjaan di Pending atau Running status yang dapat dibatalkan.

Pahami responsnya

CancelJobTanggapan mengonfirmasi permintaan pembatalan dan memberikan status pekerjaan yang diperbarui. Karena pembatalan tidak sinkron, Anda harus menggunakan GetJob operasi untuk memantau pekerjaan hingga mencapai status. Cancelled

Tanggapan tersebut mencakup bidang-bidang berikut:

Identifikasi Job

Pengidentifikasi unik untuk pekerjaan yang dibatalkan.

  • JobId: Pengidentifikasi pekerjaan unik.

  • JobArn: Nama Sumber Daya Amazon (ARN) dari pekerjaan yang dibatalkan.

Status pembatalan

Status pekerjaan saat ini setelah permintaan pembatalan.

  • Status: Status Job segera setelah permintaan pembatalan. Biasanya Cancelling untuk menunjukkan pembatalan sedang berlangsung. Transisi status ke Cancelled saat pembatalan selesai. Gunakan GetJob untuk memantau transisi ini.

catatan

Pekerjaan yang dibatalkan mungkin memiliki hasil sebagian di lokasi output tergantung pada kapan pembatalan terjadi selama pemrosesan. Periksa lokasi keluaran untuk menentukan apakah ada sebagian data yang ditulis sebelum pembatalan selesai. Anda ditagih untuk jumlah catatan yang diproses dan ditulis ke bucket keluaran Anda sebelum pekerjaan dibatalkan.