調用UpdateJobStatus介面更新指定大量操作任務的狀態。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
UpdateJobStatus |
| 更新大量操作任務的狀態。 |
請求文法
POST /?batchJobStatus&batchJobId=xx&requestedJobStatus=RequestedJobStatus&statusUpdateReason=StatusUpdateReason HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
batchJobId | 字串 | 是 | MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= | 大量操作任務的ID。長度為44個字元，不包含短劃線（-）和底線（_），可以包含小寫字母（a-z）、大寫字母（A-Z）、數字（0-9）。 父節點：無 子節點：無 |
requestedJobStatus | 字串 | 是 | Cancelled | 請求更新的任務狀態。狀態更新會影響任務的執行流程。有效值： 父節點：無 子節點：無 |
statusUpdateReason | 字串 | 可選 | User requested cancellation | 狀態更新的原因。當 父節點：無 子節點：無 |
要求標頭
此介面除支援公用要求標頭外，無特有要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。
響應元素
名稱 | 類型 | 樣本值 | 描述 |
UpdateJobStatusResult | 容器 | 無 | 響應的根節點。 父節點：無 子節點：JobId、Status、StatusUpdateReason |
JobId | 字串 | MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= | 任務ID。 父節點：UpdateJobStatusResult 子節點：無 |
Status | 字串 | Cancelling | 更新後的任務狀態。 父節點：UpdateJobStatusResult 子節點：無 |
StatusUpdateReason | 字串 | User requested cancellation | 狀態更新的原因。 父節點：UpdateJobStatusResult 子節點：無 |
回應標頭
此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。
樣本
請求樣本
POST /?batchJobStatus&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=&requestedJobStatus=Cancelled&statusUpdateReason=User%20requested%20cancellation HTTP/1.1 Host: oss-cn-hangzhou.aliyuncs.com Authorization: OSS LTAI4Fw2Nb3o4f5a3a1f****:2s98lj9n796c9kdc6b5f4l5b****響應樣本
HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <UpdateJobStatusResult> <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId> <Status>Cancelling</Status> <StatusUpdateReason>User requested cancellation</StatusUpdateReason> </UpdateJobStatusResult>