:doc:`Transfer <../../transfer>` / Client / list_tags_for_resource

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



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

  

  Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a user, server, or role.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListTagsForResource>`_  


  **Request Syntax**
  ::

    response = client.list_tags_for_resource(
        Arn='string',
        MaxResults=123,
        NextToken='string'
    )
    
  :type Arn: string
  :param Arn: **[REQUIRED]** 

    Requests the tags associated with a particular Amazon Resource Name (ARN). An ARN is an identifier for a specific Amazon Web Services resource, such as a server, user, or role.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    Specifies the number of tags to return as a response to the ``ListTagsForResource`` request.

    

  
  :type NextToken: string
  :param NextToken: 

    When you request additional results from the ``ListTagsForResource`` operation, a ``NextToken`` parameter is returned in the input. You can then pass in a subsequent command to the ``NextToken`` parameter to continue listing additional tags.

    

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

    
    ::

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

    

    - *(dict) --* 
      

      - **Arn** *(string) --* 

        The ARN you specified to list the tags of.

        
      

      - **NextToken** *(string) --* 

        When you can get additional results from the ``ListTagsForResource`` call, a ``NextToken`` parameter is returned in the output. You can then pass in a subsequent command to the ``NextToken`` parameter to continue listing additional tags.

        
      

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

        Key-value pairs that are assigned to a resource, usually for the purpose of grouping and searching for items. Tags are metadata that you define.

        
        

        - *(dict) --* 

          Creates a key-value pair for a specific resource. Tags are metadata that you can use to search for and group a resource for various purposes. You can apply tags to servers, users, and roles. A tag key can take more than one value. For example, to group servers for accounting purposes, you might create a tag called ``Group`` and assign the values ``Research`` and ``Accounting`` to that group.

          
          

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

            The name assigned to the tag that you create.

            
          

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

            Contains one or more values that you assigned to the key name you create.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`Transfer.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`Transfer.Client.exceptions.InternalServiceError`

  
  *   :py:class:`Transfer.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`Transfer.Client.exceptions.InvalidNextTokenException`

  