Amazon Simple Storage Service
API Reference (API Version 2006-03-01)

UpdateJobPriority

Updates an existing job's priority.

Request Syntax

POST /v20180820/jobs/id/priority?priority=Priority HTTP/1.1 x-amz-account-id: AccountId

URI Request Parameters

The request requires the following URI parameters.

id

The ID for the job whose priority you want to update. The id is required.

Length constraints: Minimum length of 5. Maximum length of 36.

priority

The priority that you want to assign to this job. The priority is required.

Valid range: Minimum value of 0. Maximum value of 2147483647.

x-amz-account-id

Length constraints: Minimum length of 1. Maximum length of 64.

Request Body

The request does not have a request body.

Response Syntax

HTTP/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.

UpdateJobPriorityResult

A root-level tag for the UpdateJobPriorityResult parameters.

Required: Yes

JobId

The ID for the job whose priority Amazon S3 updated.

Type: String

Length constraints: Minimum length of 5. Maximum length of 36.

Priority

The new priority assigned to the specified job.

Type: Integer

Valid range: Minimum value of 0. Maximum value of 2147483647.

Errors

BadRequestException

HTTP Status Code: 400

InternalServiceException

HTTP Status Code: 500

NotFoundException

HTTP Status Code: 400

TooManyRequestsException

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: