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

**********************
list_tags_for_resource
**********************



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

  

  This operation allows you to list all of the tags for a specified resource. Each tag is a label consisting of a key and value. Tags can help you organize, track costs for, and control access to resources.

   

  .. 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:ListTagsForResource`` permission to use this operation.

    Directory bucket permissions  

  For directory buckets, you must have the ``s3express:ListTagsForResource`` 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/ListTagsForResource>`_  


  **Request Syntax**
  ::

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

    The Amazon Web Services account ID of the resource owner.

    

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

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

    

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

    
    ::

      {
          'Tags': [
              {
                  'Key': 'string',
                  'Value': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Tags** *(list) --* 

        The Amazon Web Services resource tags that are associated with the resource.

        
        

        - *(dict) --* 

          A key-value pair that you use to label your resources. You can add tags to new resources when you create them, or you can add tags to existing resources. Tags can help you organize, track costs for, and control access to resources.

          
          

          - **Key** *(string) --* 

            The key of the key-value pair of a tag added to your Amazon Web Services resource. A tag key can be up to 128 Unicode characters in length and is case-sensitive. System created tags that begin with ``aws:`` aren’t supported.

            
          

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

            The value of the key-value pair of a tag added to your Amazon Web Services resource. A tag value can be up to 256 Unicode characters in length and is case-sensitive.

            
      
    
  