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

ListQueueTags

List all cost allocation tags added to the specified Amazon SQS queue. For an overview, see Tagging 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.

  • Tagging API actions are limited to 5 TPS per AWS account. If your application requires a higher throughput, file a technical support request.

For a full list of tag restrictions, see Limits Related to Queues 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

Response Elements

The following element is returned by the service.

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

The list of all tags added to the specified queue.

Type: String to string map

Errors

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

Example

Sample Request

http://sqs.us-east-2.amazonaws.com/123456789012/MyQueue/ ?Action=ListQueueTags &Version=2012-11-05 &Expires=2020-10-18T22%3A52%3A43PST &AUTHPARAMS

Sample Response

<ListQueueTagsResponse> <ListQueueTagsResult> <Tag> <Key>QueueType</Key> <Value>Production</Value> </Tag> <Tag> <Key>Owner</Key> <Value>Developer123</Value> </Tag> </ListQueueTagsResult> <ResponseMetadata> <RequestId>a1b2c3d4-e567-8901-23f4-g5678901hi23</RequestId> </ResponseMetadata> </ListQueueTagsResponse>

See Also

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