AppMesh / Client / list_tags_for_resource

list_tags_for_resource#

AppMesh.Client.list_tags_for_resource(**kwargs)#

List the tags for an App Mesh resource.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    limit=123,
    nextToken='string',
    resourceArn='string'
)
Parameters:
  • limit (integer) – 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.

  • nextToken (string) – 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.

  • resourceArn (string) –

    [REQUIRED]

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

Return type:

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

  • AppMesh.Client.exceptions.NotFoundException

  • AppMesh.Client.exceptions.BadRequestException

  • AppMesh.Client.exceptions.TooManyRequestsException

  • AppMesh.Client.exceptions.ForbiddenException

  • AppMesh.Client.exceptions.ServiceUnavailableException

  • AppMesh.Client.exceptions.InternalServerErrorException