ListTagsForResources - Amazon Route 53
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Lists tags for up to 10 health checks or hosted zones.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the Amazon Billing and Cost Management User Guide.

Request Syntax

POST /2013-04-01/tags/ResourceType HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <ListTagsForResourcesRequest xmlns=""> <ResourceIds> <ResourceId>string</ResourceId> </ResourceIds> </ListTagsForResourcesRequest>

URI Request Parameters

The request uses the following URI parameters.


The type of the resources.

  • The resource type for health checks is healthcheck.

  • The resource type for hosted zones is hostedzone.

Valid Values: healthcheck | hostedzone

Required: Yes

Request Body

The request accepts the following data in XML format.


Root level tag for the ListTagsForResourcesRequest parameters.

Required: Yes


A complex type that contains the ResourceId element for each resource for which you want to get a list of tags.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Length Constraints: Maximum length of 64.

Required: Yes

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <ListTagsForResourcesResponse> <ResourceTagSets> <ResourceTagSet> <ResourceId>string</ResourceId> <ResourceType>string</ResourceType> <Tags> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </Tags> </ResourceTagSet> </ResourceTagSets> </ListTagsForResourcesResponse>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service.


Root level tag for the ListTagsForResourcesResponse parameters.

Required: Yes


A list of ResourceTagSets containing tags associated with the specified resources.

Type: Array of ResourceTagSet objects


For information about the errors that are common to all actions, see Common Errors.


The input is not valid.

HTTP Status Code: 400


No health check exists with the specified ID.

HTTP Status Code: 404


No hosted zone exists with the ID that you specified.

HTTP Status Code: 404


If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.

HTTP Status Code: 400


The limit on the number of requests per second was exceeded.

HTTP Status Code: 400


Example Request

This example illustrates one usage of ListTagsForResources.

GET /2013-04-01/tags/healthcheck HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <ListTagsForResourcesRequest xmlns=""> <ResourceIds> <ResourceId>abcdef11-2222-3333-4444-555555fedcba</ResourceId> <ResourceId>aaaaaaaa-1234-5678-9012-bbbbbbcccccc</ResourceId> </ResourceIds> </ListTagsForResourcesRequest>

Example Response

This example illustrates one usage of ListTagsForResources.

HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <ListTagsForResourcesResponse xmlns=""> <ResourceTagSets> <ResourceTagSet> <ResourceType>healthcheck</ResourceType> <ResourceId>abcdef11-2222-3333-4444-555555fedcba</ResourceId> <Tags> <Tag> <Key>Owner</Key> <Value>dbadmin</Value> </Tag> </Tags> </ResourceTagSet> <ResourceTagSet> <ResourceType>healthcheck</ResourceType> <ResourceId>aaaaaaaa-1234-5678-9012-bbbbbbcccccc</ResourceId> <Tags> <Tag> <Key>Cost Center</Key> <Value>80432</Value> </Tag> </Tags> </ResourceTagSet> </ResourceTagSets> </ListTagsForResourcesResponse>

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: