TagResource
Adds to or modifies the tags of the given resource. Tags are metadata that can be used to manage a resource.
Request Syntax
POST /tags?resourceArn=resourceArn HTTP/1.1
Content-type: application/json
{
"tags": [
{
"key": "string",
"value": "string"
}
]
}URI Request Parameters
The request uses the following URI parameters.
- resourceArn
-
The ARN of the resource.
Length Constraints: Minimum length of 1. Maximum length of 2048.
Required: Yes
Request Body
The request accepts the following data in JSON format.
-
The new or modified tags for the resource.
Type: Array of Tag objects
Required: Yes
Response Syntax
HTTP/1.1 200
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalFailureException
-
An internal failure occurred.
HTTP Status Code: 500
- InvalidRequestException
-
The request was invalid.
HTTP Status Code: 400
- LimitExceededException
-
A limit was exceeded.
HTTP Status Code: 410
- ResourceInUseException
-
The resource is in use.
HTTP Status Code: 409
- ResourceNotFoundException
-
The resource was not found.
HTTP Status Code: 404
- ThrottlingException
-
The request could not be completed due to throttling.
HTTP Status Code: 429
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
