TagResource - AWS Billing and Cost Management

TagResource

Adds one or more tags to a specified resource.

Request Syntax

{ "arn": "string", "tags": { "string" : "string" } }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

arn

The Amazon Resource Name (ARN) of the resource to add tags to.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: arn:aws[-a-z0-9]*:bcm-pricing-calculator:[-a-z0-9]*:[0-9]{12}:[-a-z0-9/:_]+

Required: Yes

tags

The tags to add to the resource.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 200 items.

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

Key Pattern: [\w\s:+=@/-]+

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

Value Pattern: [\w\s:+=@/-]*

Required: Yes

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.

HTTP Status Code: 400

InternalServerException

An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.

retryAfterSeconds

An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource was not found.

resourceId

The identifier of the resource that was not found.

resourceType

The type of the resource that was not found.

HTTP Status Code: 400

ServiceQuotaExceededException

The request would cause you to exceed your service quota.

quotaCode

The quota code that was exceeded.

resourceId

The identifier of the resource that exceeded quota.

resourceType

The type of the resource that exceeded quota.

serviceCode

The service code that exceeded quota.

HTTP Status Code: 400

ThrottlingException

The request was denied due to request throttling.

quotaCode

The quota code that exceeded the throttling limit.

retryAfterSeconds

The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.

serviceCode

The service code that exceeded the throttling limit.

HTTP Status Code: 400

ValidationException

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

fieldList

The list of fields that are invalid.

reason

The reason for the validation exception.

HTTP Status Code: 400

See Also

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