ListTagsForResource - Amazon Route 53

ListTagsForResource

Lists tags for one health check or hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the AWS 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.

ResourceId

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

Length Constraints: Maximum length of 64.

Required: Yes

ResourceType

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.

ListTagsForResourceResponse

Root level tag for the ListTagsForResourceResponse parameters.

Required: Yes

ResourceTagSet

A ResourceTagSet containing tags associated with the specified resource.

Type: ResourceTagSet object

Errors

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

InvalidInput

The input is not valid.

HTTP Status Code: 400

NoSuchHealthCheck

No health check exists with the specified ID.

HTTP Status Code: 404

NoSuchHostedZone

No hosted zone exists with the ID that you specified.

HTTP Status Code: 404

PriorRequestNotComplete

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

ThrottlingException

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

HTTP Status Code: 400

Examples

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="https://route53.amazonaws.com/doc/2013-04-01/"> <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 AWS SDKs, see the following: