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 |
|
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: SignatureValueRequest 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 |
|
targetPriority |
Integer |
Yes |
10 |
The new priority for the batch operation job, which dynamically adjusts the execution order. Valid values: 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 job priority update result. |
|
JobId |
string |
MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= |
The ID of the job whose priority was updated. |
|
Priority |
Integer |
20 |
The updated priority of the job. |
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>