:doc:`AppMesh <../../appmesh>` / Client / list_tags_for_resource

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



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

  

  List the tags for an App Mesh resource.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/ListTagsForResource>`_  


  **Request Syntax**
  ::

    response = client.list_tags_for_resource(
        limit=123,
        nextToken='string',
        resourceArn='string'
    )
    
  :type limit: integer
  :param limit: 

    The maximum number of tag results returned by ``ListTagsForResource`` in paginated output. When this parameter is used, ``ListTagsForResource`` returns only ``limit`` results in a single page along with a ``nextToken`` response element. You can see the remaining results of the initial request by sending another ``ListTagsForResource`` request with the returned ``nextToken`` value. This value can be between 1 and 100. If you don't use this parameter, ``ListTagsForResource`` returns up to 100 results and a ``nextToken`` value if applicable.

    

  
  :type nextToken: string
  :param nextToken: 

    The ``nextToken`` value returned from a previous paginated ``ListTagsForResource`` request where ``limit`` was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the ``nextToken`` value.

    

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

    The Amazon Resource Name (ARN) that identifies the resource to list the tags for.

    

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

    
    ::

      {
          'nextToken': 'string',
          'tags': [
              {
                  'key': 'string',
                  'value': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **nextToken** *(string) --* 

        The ``nextToken`` value to include in a future ``ListTagsForResource`` request. When the results of a ``ListTagsForResource`` request exceed ``limit``, you can use this value to retrieve the next page of results. This value is ``null`` when there are no more results to return.

        
      

      - **tags** *(list) --* 

        The tags for the resource.

        
        

        - *(dict) --* 

          Optional metadata that you apply to a resource to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

          
          

          - **key** *(string) --* 

            One part of a key-value pair that make up a tag. A ``key`` is a general label that acts like a category for more specific tag values.

            
          

          - **value** *(string) --* 

            The optional part of a key-value pair that make up a tag. A ``value`` acts as a descriptor within a tag category (key).

            
      
    
  
  **Exceptions**
  
  *   :py:class:`AppMesh.Client.exceptions.NotFoundException`

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

  
  *   :py:class:`AppMesh.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`AppMesh.Client.exceptions.ForbiddenException`

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

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

  