Update the priority of a batch operation job by calling UpdateJobPriority - Object Storage Service

The UpdateJobPriority operation updates the priority of a specified batch operation job.

Permissions

An Alibaba Cloud account has full permissions by default. However, a Resource Access Management (RAM) user or RAM role has no permissions by default. The Alibaba Cloud account or an administrator must grant the required permissions using a RAM policy or a bucket policy.

API	Action	Description
UpdateJobPriority	`oss:UpdateJobPriority`	Updates the priority of a batch operation job.

Request syntax

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

Request parameters

Name	Type	Required	Example	Description
batchJobId	string	Yes	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	The ID of the batch operation job whose priority you want to update. You can get this ID by calling the `CreateJob` operation. The ID is 44 characters long and can contain lowercase letters (a–z), uppercase letters (A–Z), and digits (0–9). The ID does not contain hyphens (-) or underscores (_).
targetPriority	Integer	Yes	10	The target priority for the batch operation job. This parameter dynamically adjusts the execution order of jobs. The valid range is 0 to 2147483647. A larger value indicates a higher priority.

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Response elements

Name	Type	Example	Description
UpdateJobPriorityResult	Container	None	The container for the result of updating the job priority. Parent node: None Child nodes: JobId, Priority
JobId	string	MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=	The ID of the job whose priority was updated. Parent node: UpdateJobPriorityResult Child node: None
Priority	Integer	20	The updated priority of the job. Parent node: UpdateJobPriorityResult Child node: None

Response headers

This operation uses only common response headers. For more information, see Common response headers.

Examples

Request example

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

Response example

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<UpdateJobPriorityResult>
   <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
   <Priority>20</Priority>
</UpdateJobPriorityResult>