Gunakan ListJobs untuk kueri batch job - Object Storage Service

Anda dapat memanggil operasi ListJobs untuk menanyakan pekerjaan batch.

Izin

Secara default, Akun Alibaba Cloud memiliki semua izin. Namun, Pengguna Resource Access Management (RAM) atau Peran RAM tidak memiliki izin apa pun. Akun Alibaba Cloud atau administrator harus memberikan izin kepada Pengguna RAM atau Peran RAM menggunakan Kebijakan RAM atau Kebijakan bucket.

API	Action	Deskripsi
ListJobs	`oss:ListJobs`	Menanyakan pekerjaan operasi batch.

Sintaks permintaan

GET /?batchJob&batchJobStatuses=JobStatuses&max-keys=MaxKeys&continuation-token=ContinuationToken HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Parameter permintaan

Nama	Tipe	Diperlukan	Contoh	Deskripsi
batchJobStatuses	String	Tidak	Complete	Kondisi filter untuk status pekerjaan. Parameter ini menyaring hasil kueri. Jika Anda tidak mengatur parameter ini, pekerjaan dalam semua status akan dikembalikan secara default. Nilai yang valid: Active, Cancelled, Cancelling, Complete, Completing, Failed, Failing, New, Paused, Pausing, Preparing, Ready, dan Suspended. Anda dapat menentukan beberapa nilai, seperti Active \| Cancelled \| Cancelling. Node induk: Tidak ada
max-keys	Integer	Tidak	100	Jumlah maksimum pekerjaan yang akan dikembalikan dalam kueri halaman. Nilainya harus berupa bilangan bulat dari 1 hingga 1.000. Nilai default adalah 100. Node induk: Tidak ada
continuation-token	String	Tidak	next-page-token-123	Token paginasi untuk kueri halaman. Jika kueri tidak mengembalikan semua hasil, server akan mengembalikan NextToken. Gunakan token ini sebagai continuation-token untuk kueri berikutnya untuk mengambil hasil yang tersisa. Token dapat memiliki panjang 1 hingga 1.024 karakter dan dapat berisi huruf besar (A-Z), huruf kecil (a-z), angka (0-9), dan karakter khusus berikut: +, :, /, =, ?, #, -, dan _. Node induk: Tidak ada

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen respons

Nama	Tipe	Contoh	Deskripsi
ListJobsResult	Kontainer	Tidak ada	Node akar dari respons. Node induk: Tidak ada Node anak: NextToken dan Jobs
NextToken	String	next-page-token-456	Token untuk halaman berikutnya. Jika kueri tidak mengembalikan semua hasil, elemen ini disertakan dalam respons. Anda dapat menggunakan token ini sebagai continuation-token untuk kueri berikutnya untuk mengambil hasil yang tersisa. Node induk: ListJobsResult
Jobs	Kontainer	Tidak ada	Kontainer untuk daftar pekerjaan. Node induk: ListJobsResult Node anak: JobListDescriptor
JobListDescriptor	Kontainer	Tidak ada	Deskripsi pekerjaan. Node induk: Jobs Node anak: CreationTime, Description, JobId, Operation, Priority, ProgressSummary, Status, dan TerminationDate
CreationTime	Timestamp	1749983400	Waktu ketika pekerjaan dibuat. Node induk: JobListDescriptor
Description	String	Pekerjaan batch untuk menetapkan tag objek	Deskripsi pekerjaan. Node induk: JobListDescriptor
JobId	String	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	ID pekerjaan. Node induk: JobListDescriptor
Operation	String	PutObjectTagging	Operasi yang dilakukan oleh pekerjaan. Node induk: JobListDescriptor
Priority	Integer	10	Prioritas pekerjaan. Node induk: JobListDescriptor
ProgressSummary	Kontainer	Tidak ada	Ringkasan kemajuan pekerjaan saat ini. Node induk: JobListDescriptor Node anak: NumberOfTasksFailed, NumberOfTasksSucceeded, Timers, dan TotalNumberOfTasks
NumberOfTasksFailed	Long	0	Jumlah tugas yang gagal. Node induk: ProgressSummary
NumberOfTasksSucceeded	Long	1000	Jumlah tugas yang berhasil. Node induk: ProgressSummary
Timers	Kontainer	Tidak ada	Informasi tentang waktu eksekusi. Node induk: ProgressSummary Node anak: ElapsedTimeInActiveSeconds
ElapsedTimeInActiveSeconds	Long	3600	Waktu eksekusi dalam detik. Node induk: Timers
TotalNumberOfTasks	Long	1000	Jumlah total tugas. Node induk: ProgressSummary
Status	String	Complete	Status eksekusi saat ini. Nilai yang valid: New: Pekerjaan baru saja dibuat dan belum mulai persiapan. Preparing: Sistem sedang menguraikan file manifest, mengotentikasi izin, dan menginisialisasi sumber daya. Ready: Pekerjaan telah menyelesaikan persiapan dan sedang menunggu untuk dijadwalkan dan dieksekusi oleh sistem. Suspended: Pekerjaan memerlukan konfirmasi eksplisit dari pengguna untuk melanjutkan. Ini terjadi ketika ConfirmationRequired diatur ke true selama pembuatan pekerjaan. Active: Pekerjaan sedang memproses objek dalam batch. Anda dapat melihat kemajuan real-time di ProgressSummary. Pausing: Sistem sedang menjeda pekerjaan. Ini hanya berlaku untuk pekerjaan ini. Paused: Pekerjaan dijeda. Layanan OSS secara otomatis melanjutkan pekerjaan. Completing: Semua objek telah diproses. Sistem sedang menghasilkan laporan eksekusi dan membersihkan sumber daya. Complete: Pekerjaan berhasil diselesaikan. Ini adalah status yang diinginkan. Cancelling: Sistem sedang membatalkan pekerjaan. Cancelled: Pekerjaan dibatalkan oleh pengguna. Ini adalah status yang diinginkan. Failing: Pekerjaan mengalami kesalahan kritis, dan sistem menghentikan eksekusinya. Failed: Pekerjaan dihentikan karena kesalahan tingkat sistem. Untuk informasi lebih lanjut tentang penyebabnya, lihat bidang FailureReasons. Ini adalah status yang diinginkan. Node induk: JobListDescriptor
TerminationDate	Timestamp	1749987000	Waktu ketika pekerjaan dihentikan. Node induk: JobListDescriptor

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

GET /?batchJob&batchJobStatuses=Complete&max-keys=10&continuation-token=next-page-token-123 HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Contoh Respons

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<ListJobsResult>
   <NextToken>next-page-token-456</NextToken>
   <Jobs>
      <JobListDescriptor>
         <CreationTime>1749983400</CreationTime>
         <Description>Batch job for setting object tags</Description>
         <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
         <Operation>PutObjectTagging</Operation>
         <Priority>10</Priority>
         <ProgressSummary>
            <NumberOfTasksFailed>0</NumberOfTasksFailed>
            <NumberOfTasksSucceeded>1000</NumberOfTasksSucceeded>
            <Timers>
               <ElapsedTimeInActiveSeconds>3600</ElapsedTimeInActiveSeconds>
            </Timers>
            <TotalNumberOfTasks>1000</TotalNumberOfTasks>
         </ProgressSummary>
         <Status>Complete</Status>
         <TerminationDate>1749987000</TerminationDate>
      </JobListDescriptor>
   </Jobs>
</ListJobsResult>