:doc:`AppStream <../../appstream>` / Client / tag_resource

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



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

  

  Adds or overwrites one or more tags for the specified WorkSpaces Applications resource. You can tag WorkSpaces Applications image builders, images, fleets, and stacks.

   

  Each tag consists of a key and an optional value. If a resource already has a tag with the same key, this operation updates its value.

   

  To list the current tags for your resources, use  ListTagsForResource. To disassociate tags from your resources, use  UntagResource.

   

  For more information about tags, see `Tagging Your Resources <https://docs.aws.amazon.com/appstream2/latest/developerguide/tagging-basic.html>`__ in the *Amazon WorkSpaces Applications Administration Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/TagResource>`_  


  **Request Syntax**
  ::

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

    The Amazon Resource Name (ARN) of the resource.

    

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

    The tags to associate. A tag is a key-value pair, and the value is optional. For example, Environment=Test. If you do not specify a value, Environment=.

     

    If you do not specify a value, the value is set to an empty string.

     

    Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following special characters:

     

    _ . : / = + \ - @

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`AppStream.Client.exceptions.LimitExceededException`

  
  *   :py:class:`AppStream.Client.exceptions.InvalidAccountStatusException`

  
  *   :py:class:`AppStream.Client.exceptions.ResourceNotFoundException`

  