全部文档
当前文档
最近更新时间：2025-12-02 17:08:53
该接口用于更新批量处理任务优先级。任务优先级数值越大，优先级越高，高优先级的任务会被优先执行。
使用该接口的用户，必须是主账号或具有ks3:UpdateJobPriority权限。
PUT /?jobs&jobId=<jobId>&action=<action>&priority=<priority> HTTP/1.1
Host: ks3-cn-beijing.ksyuncs.com
Date: {date}
Authorization: {SignatureValue}参数 | 描述 | 是否必选 |
jobId | 任务ID。
 每个任务对应唯一的任务ID，创建批量处理任务（CreateJob）成功后，KS3会返回任务ID。 | 是 |
action | 表示执行更新任务状态的操作。固定取值：
| 是 |
priority | 任务优先级，取值越大表示任务执行的优先级越高。
| 是 |
该接口仅使用公共请求头。
该接口不使用请求体。
该接口仅返回公共响应头部。
响应体为一段描述任务当前优先级信息的XML：
<UpdateJobPriorityResult>
<JobId>string</JobId>
<Priority>integer</Priority>
</UpdateJobPriorityResult>响应体内具体元素描述如下所示：
名称 | 描述 |
UpdateJobPriorityResult | 包含任务当前优先级信息的容器。
|
JobId | 任务ID。
每个任务对应唯一的任务ID，创建批量处理任务（CreateJob）成功后，KS3会返回任务ID。 |
Priority | 任务的当前优先级。任务优先级数值越大，优先级越高，高优先级的任务会被优先执行。
|
PUT /?jobs&jobId=184ce261-18af-5e3d-3e30-253723cfd937&action=updateJobPriority&priority=100 HTTP/1.1
Host: ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2025 12:00:00 GMT
Authorization: authorization stringHTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: Wed, 01 Mar 2025 12:00:00 GMT
Server: ks3
x-kss-request-id: 5CAC0AD16D0232E2051B****
<UpdateJobPriorityResult>
<JobId>184ce261-18af-5e3d-3e30-253723cfd937</JobId>
<Priority>1</Priority>
</UpdateJobPriorityResult>状态码（Status） | 错误码（Code） | 描述 |
404 Bad Request | NoSuchJob | 指定任务不存在 |
400 Bad Request | InvalidRequest | 存在以下场景：
|
纯净模式