Gunakan UpdateJobStatus untuk memperbarui status pekerjaan operasi batch - Object Storage Service

Anda dapat memanggil operasi UpdateJobStatus untuk memperbarui status pekerjaan operasi batch yang ditentukan.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Namun, Pengguna Manajemen Akses Sumber Daya (RAM) dan Peran RAM tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator harus memberikan izin untuk operasi ini menggunakan Kebijakan RAM atau kebijakan bucket.

API	Action	Deskripsi
UpdateJobStatus	`oss:UpdateJobStatus`	Memperbarui status pekerjaan operasi batch.

Sintaks permintaan

POST /?batchJobStatus&batchJobId=xx&requestedJobStatus=RequestedJobStatus&statusUpdateReason=StatusUpdateReason HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Parameter permintaan

Nama	Tipe	Diperlukan	Contoh	Deskripsi
batchJobId	string	Ya	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	ID pekerjaan operasi batch. ID tersebut harus memiliki panjang 44 karakter dan hanya boleh berisi huruf kecil (a-z), huruf besar (A-Z), serta angka (0-9). ID tidak boleh mengandung tanda hubung (-) atau garis bawah (_). Node induk: Tidak ada Node anak: Tidak ada
requestedJobStatus	string	Ya	Cancelled	Status yang ingin Anda perbarui untuk pekerjaan tersebut. Pembaruan status memengaruhi alur eksekusi pekerjaan. Nilai valid: `Cancelled` dan `Ready`. Anda tidak dapat menetapkan parameter ini ke `Cancelled` jika status saat ini dari pekerjaan adalah `Cancelled`, `Cancelling`, `Complete`, `Completing`, `Failed`, atau `Failing`. Anda hanya dapat menetapkan parameter ini ke `Ready` jika status saat ini dari pekerjaan adalah `Suspended` atau `Preparing`. Node induk: Tidak ada Node anak: Tidak ada
statusUpdateReason	string	Opsional	Pengguna meminta pembatalan	Alasan pembaruan status. Parameter ini bersifat opsional jika `requestedJobStatus` diatur ke `Ready`. Alasan tersebut harus memiliki panjang antara 1 hingga 256 karakter. Node induk: Tidak ada Node anak: 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
UpdateJobStatusResult	Container	Tidak ada	Node root dari respons. Node induk: Tidak ada Node anak: JobId, Status, dan StatusUpdateReason
JobId	string	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	ID pekerjaan. Node induk: UpdateJobStatusResult Node anak: Tidak ada
Status	string	Cancelling	Status terbaru dari pekerjaan. Node induk: UpdateJobStatusResult Node anak: Tidak ada
StatusUpdateReason	string	Pengguna meminta pembatalan	Alasan pembaruan status. Node induk: UpdateJobStatusResult Node anak: Tidak ada

Header respons

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

Contoh

Contoh Permintaan

POST /?batchJobStatus&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=&requestedJobStatus=Cancelled&statusUpdateReason=User%20requested%20cancellation HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS LTAI4Fw2Nb3o4f5a3a1f****:2s98lj9n796c9kdc6b5f4l5b****

Contoh Respons

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<UpdateJobStatusResult>
   <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
   <Status>Cancelling</Status>
   <StatusUpdateReason>Pengguna meminta pembatalan</StatusUpdateReason>
</UpdateJobStatusResult>