:doc:`EVS <../../evs>` / Client / tag_resource

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



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

  

  Associates the specified tags to an Amazon EVS resource with the specified ``resourceArn``. If existing tags on a resource are not specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted. Tags that you create for Amazon EVS resources don't propagate to any other resources associated with the environment. For example, if you tag an environment with this operation, that tag doesn't automatically propagate to the VLAN subnets and hosts associated with the environment.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/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 to add tags to.

    

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

    Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other environment or Amazon Web Services resources.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`EVS.Client.exceptions.ServiceQuotaExceededException`

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

  
  *   :py:class:`EVS.Client.exceptions.TooManyTagsException`

  
  *   :py:class:`EVS.Client.exceptions.TagPolicyException`

  