:doc:`SQS <../../sqs>` / Client / tag_queue

*********
tag_queue
*********



.. py:method:: SQS.Client.tag_queue(**kwargs)

  

  Add cost allocation tags to the specified Amazon SQS queue. For an overview, see `Tagging Your Amazon SQS Queues <https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html>`__ 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 <https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues>`__ in the *Amazon SQS Developer Guide*.

   

  .. note::

    

    Cross-account permissions don't apply to this action. For more information, see `Grant cross-account permissions to a role and a username <https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name>`__ in the *Amazon SQS Developer Guide*.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/TagQueue>`_  


  **Request Syntax**
  ::

    response = 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
  **Exceptions**
  
  *   :py:class:`SQS.Client.exceptions.InvalidAddress`

  
  *   :py:class:`SQS.Client.exceptions.RequestThrottled`

  
  *   :py:class:`SQS.Client.exceptions.QueueDoesNotExist`

  
  *   :py:class:`SQS.Client.exceptions.InvalidSecurity`

  
  *   :py:class:`SQS.Client.exceptions.UnsupportedOperation`

  