View a markdown version of this page

GetJob - Amazon Location Service
Kasus penggunaanPahami permintaannyaPahami tanggapannya

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

GetJob

GetJobOperasi mengambil informasi tentang pekerjaan tertentu, termasuk status saat ini, konfigurasi, stempel waktu, dan informasi kesalahan apa pun. Gunakan operasi ini untuk memantau kemajuan pekerjaan dan memverifikasi detail konfigurasi. Untuk pekerjaan yang diselesaikan, Anda dapat menggunakan informasi ini untuk memverifikasi pemrosesan yang berhasil sebelum mengakses hasil.

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

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

Kasus penggunaan

  • Status pekerjaan dan pemantauan kemajuan: Lacak perkembangan siklus hidup pekerjaan melalui status tertunda, berjalan, dan penyelesaian untuk menentukan kapan pemrosesan selesai dan hasilnya tersedia untuk diunduh. Memantau status pekerjaan untuk manajemen alur kerja dan pelaporan.

  • Diagnosis kesalahan: Ambil informasi kesalahan terperinci saat pekerjaan gagal, termasuk pesan kesalahan tertentu dan alasan kegagalan untuk memecahkan masalah pemrosesan.

  • Verifikasi konfigurasi: Konfirmasikan detail konfigurasi pekerjaan termasuk input/output lokasi, peran eksekusi, dan fitur yang diminta sebelum pemrosesan dimulai.

Pahami permintaannya

GetJobPermintaan hanya membutuhkan satu parameter untuk mengambil informasi komprehensif tentang pekerjaan tertentu. Struktur permintaan sederhana ini memudahkan untuk memantau status pekerjaan dan mengambil konfigurasi terperinci dan memproses informasi.

Permintaan tersebut mencakup parameter berikut:

Identifikasi Job

Parameter yang diperlukan menentukan pekerjaan mana untuk mengambil informasi tentang.

  • JobId: Pengidentifikasi unik dari pekerjaan yang akan diambil. Harus 1-100 karakter pola [-._\w]+ pencocokan. Ini adalah pengenal yang sama yang dikembalikan oleh StartJob operasi saat pekerjaan dibuat.

Pahami tanggapannya

GetJobRespons memberikan informasi tentang pekerjaan yang ditentukan, termasuk statusnya saat ini, konfigurasi lengkap, stempel waktu pemrosesan, dan informasi kesalahan apa pun. Anda dapat menggunakan respons ini untuk memantau status pekerjaan dan memecahkan masalah kesalahan apa pun yang mungkin timbul.

Tanggapan tersebut mencakup bidang-bidang berikut:

Identifikasi Job

Pengidentifikasi unik dan informasi pekerjaan dasar.

  • JobId: Pengidentifikasi pekerjaan unik yang digunakan untuk operasi pemantauan dan manajemen.

  • JobArn: ARN yang secara unik mengidentifikasi pekerjaan di dalamnya. AWS

  • Name: Nama pekerjaan yang dapat dibaca manusia jika ditentukan selama penciptaan lapangan kerja.

Status pekerjaan dan siklus hidup

Status pekerjaan saat ini dan memproses informasi garis waktu.

  • Status: Status pekerjaan saat ini menunjukkan status pemrosesan (Tertunda, Berjalan, Selesai, Gagal, Membatalkan, atau Dibatalkan).

  • CreatedAt: Stempel waktu pembuatan Job dalam format ISO 8601.

  • UpdatedAt: Stempel waktu pembaruan status terakhir dalam format ISO 8601.

  • EndedAt: Stempel waktu penyelesaian pekerjaan dalam format ISO 8601. Hanya hadir untuk pekerjaan di negara terminal.

Konfigurasi Job

Lengkapi konfigurasi pekerjaan seperti yang ditentukan selama pembuatan.

  • Action: Jenis operasi yang dilakukan (saat ini hanya ValidateAddress didukung).

  • ExecutionRoleArn: Peran IAM ARN digunakan untuk mengakses bucket Amazon S3 selama eksekusi pekerjaan.

  • InputOptions: Konfigurasi input termasuk lokasi Amazon S3 dan format data.

  • OutputOptions: Konfigurasi keluaran termasuk tujuan Amazon S3 dan format hasil.

  • ActionOptions: Fitur tambahan opsional yang diminta untuk pekerjaan itu, seperti Position atauCountrySpecificAttributes.

Informasi kesalahan

Ketika pekerjaan gagal, respons menyertakan detail kesalahan untuk membantu Anda mendiagnosis dan menyelesaikan masalah.

  • Error: JobError Objek yang berisi rincian tentang kegagalan. Objek ini mencakup bidang-bidang berikut:

    • Code: Kode kesalahan yang mengidentifikasi jenis kegagalan.

    • Messages: Daftar pesan yang dapat dibaca manusia yang menyediakan konteks tambahan untuk pemecahan masalah.