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

# GetJob
<a name="get-job-api"></a>

`GetJob`Operasi 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 [GetJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_GetJob.html)di *Referensi API Amazon Location Service*.

Misalnya permintaan, tanggapan, dan perintah CLI untuk API ini, lihat [Cara memantau kemajuan pekerjaan](https://docs.aws.amazon.com/location/latest/developerguide/monitoring-job-progress.html).

## Kasus penggunaan
<a name="get-job-use-cases"></a>
+ **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
<a name="get-job-request-parameters"></a>

`GetJob`Permintaan 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
<a name="get-job-response-details"></a>

`GetJob`Respons 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` atau`CountrySpecificAttributes`.

**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.