调用UpdateJobPriority接口更新指定批量操作任务的优先级。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy概述或Bucket Policy授予操作权限。
|
API |
Action |
说明 |
|
UpdateJobPriority |
|
更新批量操作任务优先级。 |
请求语法
POST /?batchJobPriority&batchJobId=xx&targetPriority=10 HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
|
batchJobId |
字符串 |
是 |
MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= |
待更新优先级的批量操作任务ID。您可以通过调用 |
|
targetPriority |
整数 |
是 |
10 |
批量操作任务的目标优先级。用于动态调整任务的执行顺序。取值范围为0~2147483647,数值越大,优先级越高。 |
请求头
此接口除支持公共请求头外,无特有请求头。更多信息,请参见公共请求头(Common Request Headers)。
响应元素
|
名称 |
类型 |
示例值 |
描述 |
|
UpdateJobPriorityResult |
容器 |
无 |
保存更新任务优先级结果的容器。 |
|
JobId |
字符串 |
MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= |
已更新优先级的任务ID。 |
|
Priority |
整数 |
20 |
任务更新后的优先级。 |
响应头
此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。
示例
-
请求示例
POST /?batchJobPriority&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=&targetPriority=20 HTTP/1.1 Host: oss-cn-hangzhou.aliyuncs.com Authorization: SignatureValue -
返回示例
HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <UpdateJobPriorityResult> <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId> <Priority>20</Priority> </UpdateJobPriorityResult>
命令行工具ossutil
UpdateJobPriority接口所对应的ossutil命令,请参见update-job-priority。