Amazon Simple Queue Service
API Reference (API Version 2012-11-05)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

TagQueue

Add cost allocation tags to the specified Amazon SQS queue. For an overview, see Tagging Your Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

When you use queue tags, keep the following guidelines in mind:

  • Adding more than 50 tags to a queue isn't recommended.

  • Tags don't have any semantic meaning. Amazon SQS interprets tags as character strings.

  • Tags are case-sensitive.

  • A new tag with a key identical to that of an existing tag overwrites the existing tag.

For a full list of tag restrictions, see Limits Related to Queues in the Amazon Simple Queue Service Developer Guide.

Note

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

Request Parameters

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

QueueUrl

The URL of the queue.

Type: String

Required: Yes

Tag
Tag.N.Key (key)
Tag.N.Value (value)

The list of tags to be added to the specified queue.

Type: String to string map

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Errors.

Example

Sample Request

https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue/ ?Action=TagQueue &Tag.Key=QueueType &Tag.Value=Production &Expires=2020-10-18T22%3A52%3A43PST &Version=2012-11-05 &AUTHPARAMS

Sample Response

<TagQueueResponse> <ResponseMetadata> <RequestId>a1b2c3d4-e567-8901-23f4-g5678901hi23</RequestId> </ResponseMetadata> </TagQueueResponse>

See Also

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