TagResource
Assigns one or more tags (key-value pairs) to the specified resource.
Request Syntax
POST /tags/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 Amazon Resource Name (ARN) of the resource that you want to tag.
Length Constraints: Minimum length of 1. Maximum length of 1011.
Pattern:
arn:.+
Required: Yes
Request Body
The request accepts the following data in JSON format.
-
A map of the key-value pairs of the tag or tags to assign to the resource.
Type: Array of Tag objects
Array Members: Minimum number of 0 items. Maximum number of 50 items.
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.
- AccessDeniedException
-
You are not authorized to perform this operation.
HTTP Status Code: 403
- InternalServerException
-
The request processing has failed because of an unknown error, exception, or failure with an internal server.
HTTP Status Code: 500
- ResourceNotFoundException
-
The specified resource does not exist.
HTTP Status Code: 404
- ThrottlingException
-
The request rate exceeds the limit.
HTTP Status Code: 429
- ValidationException
-
The request has invalid or missing parameters.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: