UpdateJobPriority

调用UpdateJobPriority接口更新指定批量操作任务的优先级。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM PolicyBucket Policy授予操作权限。

API

Action

说明

UpdateJobPriority

oss:UpdateJobPriority

更新批量操作任务优先级。

请求语法

POST /?batchJobPriority&batchJobId=xx&targetPriority=10 HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

请求参数

名称

类型

是否必选

示例值

描述

batchJobId

字符串

MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

待更新优先级的批量操作任务ID。您可以通过调用CreateJob接口获取该ID。长度为44个字符,不包含短划线(-)和下划线(_),可以包含小写字母(a-z)、大写字母(A-Z)、数字(0-9)。

targetPriority

整数

10

批量操作任务的目标优先级。用于动态调整任务的执行顺序。取值范围为0~2147483647,数值越大,优先级越高。

请求头

此接口除支持公共请求头外,无特有请求头。更多信息,请参见公共请求头(Common Request Headers)

响应元素

名称

类型

示例值

描述

UpdateJobPriorityResult

容器

保存更新任务优先级结果的容器。
父节点:无
子节点:JobId、Priority

JobId

字符串

MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

已更新优先级的任务ID。
父节点:UpdateJobPriorityResult
子节点:无

Priority

整数

20

任务更新后的优先级。
父节点:UpdateJobPriorityResult
子节点:无

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(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>