Updates an existing S3 Batch Operations job's priority. For more information, see S3 Batch Operations in the Amazon S3 User Guide.
To use the UpdateJobPriority
operation, you must have permission to perform the s3:UpdateJobPriority
action.
Related actions include:
ImportantYou must URL encode any signed header values that contain spaces. For example, if your header value is my file.txt
, containing two spaces after my
, you must URL encode this value to my%20%20file.txt
.
POST /v20180820/jobs/id
/priority?priority=Priority
HTTP/1.1
Host: s3-control.amazonaws.com
x-amz-account-id: AccountId
URI Request Parameters
The request uses the following URI parameters.
The ID for the job whose priority you want to update.
Length Constraints: Minimum length of 5. Maximum length of 36.
Pattern: [a-zA-Z0-9\-\_]+
Required: Yes
The priority you want to assign to this job.
Valid Range: Minimum value of 0. Maximum value of 2147483647.
Required: Yes
The AWS account ID associated with the S3 Batch Operations job.
Length Constraints: Maximum length of 64.
Pattern: ^\d{12}$
Required: Yes
The request does not have a request body.
Response SyntaxHTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<UpdateJobPriorityResult>
<JobId>string</JobId>
<Priority>integer</Priority>
</UpdateJobPriorityResult>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
Root level tag for the UpdateJobPriorityResult parameters.
Required: Yes
The ID for the job whose priority Amazon S3 updated.
Type: String
Length Constraints: Minimum length of 5. Maximum length of 36.
Pattern: [a-zA-Z0-9\-\_]+
The new priority assigned to the specified job.
Type: Integer
Valid Range: Minimum value of 0. Maximum value of 2147483647.
HTTP Status Code: 400
HTTP Status Code: 500
HTTP Status Code: 400
HTTP Status Code: 400
For more information about using this API in one of the language-specific AWS SDKs, see the following:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4