:doc:`S3Control <../../s3control>` / Client / untag_resource

**************
untag_resource
**************



.. py:method:: S3Control.Client.untag_resource(**kwargs)

  

  This operation removes the specified user-defined tags from an S3 resource. You can pass one or more tag keys.

   

  .. note::

    

    This operation is only supported for the following Amazon S3 resources:

     

    
    * `General purpose buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html>`__
     
    * `Access Points for directory buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-db-tagging.html>`__
     
    * `Access Points for general purpose buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-tagging.html>`__
     
    * `Directory buckets <https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html>`__
     
    * `S3 Storage Lens groups <https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups.html>`__
     
    * `S3 Access Grants instances, registered locations, and grants <https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-tagging.html>`__.
    

    

    Permissions  

  For general purpose buckets, access points for general purpose buckets, Storage Lens groups, and S3 Access Grants, you must have the ``s3:UntagResource`` permission to use this operation.

    Directory bucket permissions  

  For directory buckets, you must have the ``s3express:UntagResource`` permission to use this operation. For more information about directory buckets policies and permissions, see `Identity and Access Management (IAM) for S3 Express One Zone <https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-permissions.html>`__ in the *Amazon S3 User Guide*.

    HTTP Host header syntax  

  **Directory buckets** - The HTTP Host header syntax is ``s3express-control.region.amazonaws.com``.

     

  For information about S3 Tagging errors, see `List of Amazon S3 Tagging error codes <https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#S3TaggingErrorCodeList>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/UntagResource>`_  


  **Request Syntax**
  ::

    response = client.untag_resource(
        AccountId='string',
        ResourceArn='string',
        TagKeys=[
            'string',
        ]
    )
    
  :type AccountId: string
  :param AccountId: **[REQUIRED]** 

    The Amazon Web Services account ID that owns the resource that you're trying to remove the tags from.

    

  
  :type ResourceArn: string
  :param ResourceArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the S3 resource that you're removing tags from. The tagged resource can be a directory bucket, S3 Storage Lens group or S3 Access Grants instance, registered location, or grant.

    

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

    The array of tag key-value pairs that you're trying to remove from of the S3 resource.

    

  
    - *(string) --* 

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  