TagQueue
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.
- 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.
Examples
Example
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: