Amazon Simple Queue Service

2017/10/19 - Amazon Simple Queue Service - 3 new api methods

Changes  Added support for tracking cost allocation by adding, updating, removing, and listing the metadata tags of Amazon SQS queues.

ListQueueTags (new) Link ¶

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 .

See also: AWS API Documentation

Request Syntax

client.list_queue_tags(
    QueueUrl='string'
)
type QueueUrl

string

param QueueUrl

[REQUIRED]

The URL of the queue.

rtype

dict

returns

Response Syntax

{
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • Tags (dict) --

      The list of all tags added to the specified queue.

      • (string) --

        • (string) --

TagQueue (new) Link ¶

Add cost allocation tags 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 .

See also: AWS API Documentation

Request Syntax

client.tag_queue(
    QueueUrl='string',
    Tags={
        'string': 'string'
    }
)
type QueueUrl

string

param QueueUrl

[REQUIRED]

The URL of the queue.

type Tags

dict

param Tags

[REQUIRED]

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

  • (string) --

    • (string) --

returns

None

UntagQueue (new) Link ¶

Remove cost allocation tags from 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 .

See also: AWS API Documentation

Request Syntax

client.untag_queue(
    QueueUrl='string',
    TagKeys=[
        'string',
    ]
)
type QueueUrl

string

param QueueUrl

[REQUIRED]

The URL of the queue.

type TagKeys

list

param TagKeys

[REQUIRED]

The list of tags to be removed from the specified queue.

  • (string) --

returns

None