Menu
Amazon Simple Queue Service
Developer Guide

Tagging Your Amazon SQS Queues

To organize and identify your Amazon SQS queues for cost allocation, you can add metadata tags that identify a queue's purpose, owner, or environment. This is especially useful when you have many queues.

You can use cost allocation tags to organize your AWS bill to reflect your own cost structure. To do this, sign up to get your AWS account bill to include tag keys and values. For more information, see Setting Up a Monthly Cost Allocation Report in the AWS Billing and Cost Management User Guide.

Overview

Each tag consists of a key-value pair that you define. For example, you can easily identify your production and testing queues if you tag your queues as follows:

Queue Key Value
MyQueueA QueueType Production
MyQueueB QueueType Testing

Note

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

  • We don't recommend adding more than 50 tags to a queue.

  • 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.

You can't add tags to a queue when you create it. However, you can add, update, or remove tags for existing queues at any time using the AWS Management Console or the Amazon SQS API.

Getting Started with Tagging

For information on how to manage Amazon SQS queue tags using the AWS Management Console or API actions, see the Adding, Updating, and Removing Tags from an Amazon SQS Queue tutorial.

You can list, add, update, or remove tags for an Amazon SQS queue using the following API actions:

Task API Action
Add tags to a queue or update the tags added to a queue TagQueue
Remove tags from a queue UntagQueue
List the tags added to a queue ListQueueTags