:doc:`CloudTrail <../../cloudtrail>` / Client / remove_tags

***********
remove_tags
***********



.. py:method:: CloudTrail.Client.remove_tags(**kwargs)

  

  Removes the specified tags from a trail, event data store, dashboard, or channel.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RemoveTags>`_  


  **Request Syntax**
  ::

    response = client.remove_tags(
        ResourceId='string',
        TagsList=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type ResourceId: string
  :param ResourceId: **[REQUIRED]** 

    Specifies the ARN of the trail, event data store, dashboard, or channel from which tags should be removed.

     

    Example trail ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail``

     

    Example event data store ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE``

     

    Example dashboard ARN format: ``arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash``

     

    Example channel ARN format: ``arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890``

    

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

    Specifies a list of tags to be removed.

    

  
    - *(dict) --* 

      A custom key-value pair associated with a resource such as a CloudTrail trail, event data store, dashboard, or channel.

      

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

        The key in a key-value pair. The key must be must be no longer than 128 Unicode characters. The key must be unique for the resource to which it applies.

        

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

        The value in a key-value pair of a tag. The value must be no longer than 256 Unicode characters.

        

      
    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 

      Returns the objects or data listed below if successful. Otherwise, returns an error.

      
  
  **Exceptions**
  
  *   :py:class:`CloudTrail.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`CloudTrail.Client.exceptions.CloudTrailARNInvalidException`

  
  *   :py:class:`CloudTrail.Client.exceptions.EventDataStoreARNInvalidException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ChannelARNInvalidException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ResourceTypeNotSupportedException`

  
  *   :py:class:`CloudTrail.Client.exceptions.InvalidTrailNameException`

  
  *   :py:class:`CloudTrail.Client.exceptions.InvalidTagParameterException`

  
  *   :py:class:`CloudTrail.Client.exceptions.InactiveEventDataStoreException`

  
  *   :py:class:`CloudTrail.Client.exceptions.EventDataStoreNotFoundException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ChannelNotFoundException`

  
  *   :py:class:`CloudTrail.Client.exceptions.UnsupportedOperationException`

  
  *   :py:class:`CloudTrail.Client.exceptions.OperationNotPermittedException`

  
  *   :py:class:`CloudTrail.Client.exceptions.NotOrganizationMasterAccountException`

  
  *   :py:class:`CloudTrail.Client.exceptions.NoManagementAccountSLRExistsException`

  
  *   :py:class:`CloudTrail.Client.exceptions.ConflictException`

  