ListTagsForResource - 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 one health check or hosted zone.

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

Request Syntax

GET /2013-04-01/tags/ResourceType/ResourceId HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The ID of the resource for which you want to retrieve tags.

Length Constraints: Maximum length of 64.

Required: Yes


The type of the resource.

  • 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 does not have a request body.

Response Syntax

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

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 ListTagsForResourceResponse parameters.

Required: Yes


A ResourceTagSet containing tags associated with the specified resource.

Type: ResourceTagSet object


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 ListTagsForResource.

GET /2013-04-01/tags/healthcheck/abcdef11-2222-3333-4444-555555fedcba

Example Response

This example illustrates one usage of ListTagsForResource.

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

See Also

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