ChangeTagsForResource - Amazon Route 53

ChangeTagsForResource

Adds, edits, or deletes tags for a health check or a 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

POST /2013-04-01/tags/ResourceType/ResourceId HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <ChangeTagsForResourceRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <AddTags> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </AddTags> <RemoveTagKeys> <Key>string</Key> </RemoveTagKeys> </ChangeTagsForResourceRequest>

URI Request Parameters

The request uses the following URI parameters.

ResourceId

The ID of the resource for which you want to add, change, or delete 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 accepts the following data in XML format.

ChangeTagsForResourceRequest

Root level tag for the ChangeTagsForResourceRequest parameters.

Required: Yes

AddTags

A complex type that contains a list of the tags that you want to add to the specified health check or hosted zone and/or the tags that you want to edit Value for.

You can add a maximum of 10 tags to a health check or a hosted zone.

Type: Array of Tag objects

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

Required: No

RemoveTagKeys

A complex type that contains a list of the tags that you want to delete from the specified health check or hosted zone. You can specify up to 10 keys.

Type: Array of strings

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

Length Constraints: Maximum length of 128.

Required: No

Response Syntax

HTTP/1.1 200

Response Elements

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

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

POST /2013-04-01/tags/healthcheck/abcdef11-2222-3333-4444-555555fedcba HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <ChangeTagsForResourceRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <RemoveTagKeys> <Key>Owner</Key> </RemoveTagKeys> <AddTags> <Tag> <Key>Cost Center</Key> <Value>80432</Value> </Tag> </AddTags> </ChangeTagsForResourceRequest>

Example Response

This example illustrates one usage of ChangeTagsForResource.

HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <ChangeTagsForResourceResponse xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> </ChangeTagsForResourceResponse>

See Also

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