GetJobTagging
Returns the tags on an S3 Batch Operations job.
- Permissions
-
To use the
GetJobTagging
operation, you must have permission to perform thes3:GetJobTagging
action. For more information, see Controlling access and labeling jobs using tags in the Amazon S3 User Guide.
Related actions include:
Request Syntax
GET /v20180820/jobs/id
/tagging HTTP/1.1
Host: s3-control.amazonaws.com.cn
x-amz-account-id: AccountId
URI Request Parameters
The request uses the following URI parameters.
- id
-
The ID for the S3 Batch Operations job whose tags you want to retrieve.
Length Constraints: Minimum length of 5. Maximum length of 36.
Pattern:
[a-zA-Z0-9\-\_]+
Required: Yes
- x-amz-account-id
-
The Amazon Web Services account ID associated with the S3 Batch Operations job.
Length Constraints: Maximum length of 64.
Pattern:
^\d{12}$
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<GetJobTaggingResult>
<Tags>
<S3Tag>
<Key>string</Key>
<Value>string</Value>
</S3Tag>
</Tags>
</GetJobTaggingResult>
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.
- GetJobTaggingResult
-
Root level tag for the GetJobTaggingResult parameters.
Required: Yes
- Tags
-
The set of tags associated with the S3 Batch Operations job.
Type: Array of S3Tag data types
Errors
- 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 Amazon SDKs, see the following: