View a markdown version of this page

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

ListJobs

ListJobsOperasi mengambil daftar pekerjaan yang diberi halaman dengan kemampuan penyaringan opsional. Anda dapat memfilter berdasarkan status pekerjaan dan mengontrol jumlah hasil yang dikembalikan. Operasi ini mendukung pagination melalui token berikutnya, memungkinkan Anda untuk mengambil daftar pekerjaan besar secara efisien.

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

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

Kasus penggunaan

  • Manajemen inventaris pekerjaan: Ambil semua pekerjaan untuk mengaudit riwayat pemrosesan dan melacak pemanfaatan sumber daya di seluruh operasi validasi.

  • Pemantauan berbasis status: Filter pekerjaan berdasarkan status untuk mengidentifikasi pekerjaan yang sedang berjalan yang membutuhkan perhatian atau menyelesaikan pekerjaan yang siap untuk pengambilan hasil.

  • Pelaporan operasional: Menghasilkan laporan tentang pola pelaksanaan pekerjaan, tingkat keberhasilan, dan volume pemrosesan untuk analisis bisnis.

  • Pemecahan masalah dan debugging: Buat daftar pekerjaan yang gagal untuk mengidentifikasi pola dalam memproses kesalahan dan mendiagnosis masalah sistematis.

Pahami permintaannya

ListJobsPermintaan menerima parameter opsional untuk pemfilteran dan pagination. Tanpa parameter apa pun, operasi mengembalikan semua pekerjaan dengan pagination default.

Permintaan mencakup parameter opsional berikut:

Opsi penyaringan

Parameter opsional untuk mempersempit daftar pekerjaan yang dikembalikan.

  • Filter: Objek yang berisi kriteria filter.

    • JobStatus: Filter pekerjaan berdasarkan statusnya saat ini. Nilai yang valid: PendingRunning,Completed,Failed,Cancelling, atauCancelled.

Kontrol pagination

Parameter opsional untuk mengontrol pagination hasil.

  • MaxResults: Jumlah maksimum pekerjaan untuk dikembalikan dalam satu respons. Gunakan ini untuk mengontrol ukuran halaman untuk set hasil besar.

  • NextToken: Token pagination dari ListJobs respons sebelumnya. Sertakan token ini untuk mengambil halaman hasil berikutnya.

Pahami tanggapannya

ListJobsResponsnya menyediakan daftar ringkasan pekerjaan dengan konfigurasi dan informasi status untuk setiap pekerjaan. Gunakan token berikutnya untuk mengambil halaman tambahan ketika lebih banyak hasil tersedia.

Tanggapan tersebut mencakup bidang-bidang berikut:

Daftar Job

Array ringkasan pekerjaan yang cocok dengan kriteria filter.

  • Entries: Array ringkasan pekerjaan, termasuk:

    • Action: Tindakan yang dilakukan oleh pekerjaan.

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

    • EndedAt: Stempel waktu penyelesaian pekerjaan dalam format ISO 8601. Hanya hadir untuk pekerjaan di status terminal (Selesai, Gagal, atau Dibatalkan).

    • ExecutionRoleArn: Peran IAM digunakan untuk eksekusi.

    • InputOptions: Masukan objek konfigurasi.

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

    • JobId: Pengidentifikasi pekerjaan unik.

    • Name: Nama Job jika diberikan selama pembuatan.

    • OutputOptions: Objek konfigurasi keluaran.

    • Status: Status pekerjaan saat ini.

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

    • ActionOptions: Fitur tambahan yang diminta, jika ada.

Token pagination

Token untuk mengambil hasil tambahan.

  • NextToken: Token untuk disertakan dalam ListJobs permintaan berikutnya untuk mengambil halaman hasil berikutnya. Bidang ini hanya ada ketika lebih banyak hasil tersedia. Tidak adanya bidang ini menunjukkan Anda telah mengambil halaman terakhir.

catatan

Hasil mempertahankan urutan yang konsisten di seluruh halaman. Gunakan NextToken dari setiap respons dalam permintaan berikutnya untuk mengulangi semua halaman hasil.