:doc:`CloudFront <../../cloudfront>` / Client / tag_resource

************
tag_resource
************



.. py:method:: CloudFront.Client.tag_resource(**kwargs)

  

  Add tags to a CloudFront resource. For more information, see `Tagging a distribution <https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tagging.html>`__ in the *Amazon CloudFront Developer Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/TagResource>`_  


  **Request Syntax**
  ::

    response = client.tag_resource(
        Resource='string',
        Tags={
            'Items': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        }
    )
    
  :type Resource: string
  :param Resource: **[REQUIRED]** 

    An ARN of a CloudFront resource.

    

  
  :type Tags: dict
  :param Tags: **[REQUIRED]** 

    A complex type that contains zero or more ``Tag`` elements.

    

  
    - **Items** *(list) --* 

      A complex type that contains ``Tag`` elements.

      

    
      - *(dict) --* 

        A complex type that contains ``Tag`` key and ``Tag`` value.

        

      
        - **Key** *(string) --* **[REQUIRED]** 

          A string that contains ``Tag`` key.

           

          The string length should be between 1 and 128 characters. Valid characters include ``a-z``, ``A-Z``, ``0-9``, space, and the special characters ``_ - . : / = + @``.

          

        
        - **Value** *(string) --* 

          A string that contains an optional ``Tag`` value.

           

          The string length should be between 0 and 256 characters. Valid characters include ``a-z``, ``A-Z``, ``0-9``, space, and the special characters ``_ - . : / = + @``.

          

        
      
  
  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`CloudFront.Client.exceptions.AccessDenied`

  
  *   :py:class:`CloudFront.Client.exceptions.InvalidTagging`

  
  *   :py:class:`CloudFront.Client.exceptions.InvalidArgument`

  
  *   :py:class:`CloudFront.Client.exceptions.NoSuchResource`

  