TagQueue - Amazon Simple Queue Service


Add cost allocation tags to the specified Amazon SQS queue. For an overview, see Tagging Your Amazon SQS Queues in the Amazon SQS 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 Quotas related to queues in the Amazon SQS Developer Guide.


Cross-account permissions don't apply to this action. For more information, see Grant cross-account permissions to a role and a username in the Amazon SQS Developer Guide.

Request Parameters

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


The URL of the queue.

Type: String

Required: Yes

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


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



This example illustrates one usage of TagQueue.

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: