:doc:`Cloud9 <../../cloud9>` / Client / tag_resource

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



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

  

  Adds tags to an Cloud9 development environment.

   

  .. warning::

     

    Cloud9 is no longer available to new customers. Existing customers of Cloud9 can continue to use the service as normal. `Learn more" <http://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/>`__

     

   

  .. warning::

     

    Tags that you add to an Cloud9 environment by using this method will NOT be automatically propagated to underlying resources.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloud9-2017-09-23/TagResource>`_  


  **Request Syntax**
  ::

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

    The Amazon Resource Name (ARN) of the Cloud9 development environment to add tags to.

    

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

    The list of tags to add to the given Cloud9 development environment.

    

  
    - *(dict) --* 

      Metadata that is associated with Amazon Web Services resources. In particular, a name-value pair that can be associated with an Cloud9 development environment. There are two types of tags: *user tags* and *system tags*. A user tag is created by the user. A system tag is automatically created by Amazon Web Services services. A system tag is prefixed with ``"aws:"`` and cannot be modified by the user.

      

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

        The **name** part of a tag.

        

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

        The **value** part of a tag.

        

      
    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`Cloud9.Client.exceptions.NotFoundException`

  
  *   :py:class:`Cloud9.Client.exceptions.InternalServerErrorException`

  
  *   :py:class:`Cloud9.Client.exceptions.BadRequestException`

  
  *   :py:class:`Cloud9.Client.exceptions.ConcurrentAccessException`

  