Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

TagResource

Creates or updates a resource tag. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.

Request Syntax


PUT /tags/ResourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}

URI Request Parameters

The request uses the following URI parameters.

ResourceArn

Amazon Resource Name (ARN) for the resource you want to tag.

Length Constraints: Minimum length of 0. Maximum length of 1000.

Required: Yes

Request Body

The request accepts the following data in JSON format.

Tags

Tags that you have added to the specified resource.

Type: String to string map

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Value Length Constraints: Minimum length of 0. Maximum length of 256.

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 do not have sufficient access to perform this action. Check your permissions, and try again.

Message: Message for the AccessDeniedException error.

HTTP Status Code: 403

InternalServerException

The service encountered an internal error. Try your request again. If the problem persists, contact AWS Support.

Message: Message for the InternalServerException error.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource doesn't exist. Check the resource ID, and try again.

Message: Message for the ResourceNotFoundException error.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

Message: Message for the ThrottlingException error.

HTTP Status Code: 429

TooManyTagsException

The request exceeds the maximum number of tags allowed for this resource. Remove some tags, and try again.

Message: Message for the TooManyTagsException error.
ResourceName: Name of the resource for the TooManyTagsException error.

HTTP Status Code: 400

ValidationException

The input fails to satisfy the constraints specified by an AWS service.

Message: Message for the ValidationException error.

HTTP Status Code: 400