View a markdown version of this page

UpdateHostedZoneTier - Amazon Route 53

UpdateHostedZoneTier

You can change the tier of a hosted zone. The tier determines which features the hosted zone includes and which optional features you can turn on.

When the hosted zone moves to a new tier, Route 53 turns on the features that the new tier includes. Route 53 also disables any enabled features that the new tier doesn't include.

Before you move a hosted zone to a tier that doesn't offer an optional feature that you turned on, turn off that feature. You can't change the tier of a hosted zone that uses a CloudFront flat-rate pricing plan.

Request Syntax

POST /2013-04-01/hostedzone/Id/tier HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <UpdateHostedZoneTierRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <DryRun>boolean</DryRun> <HostedZoneTier>string</HostedZoneTier> </UpdateHostedZoneTierRequest>

URI Request Parameters

The request uses the following URI parameters.

Id

Specify the ID of the hosted zone whose tier you want to change.

Length Constraints: Maximum length of 32.

Required: Yes

Request Body

The request accepts the following data in XML format.

UpdateHostedZoneTierRequest

Root level tag for the UpdateHostedZoneTierRequest parameters.

Required: Yes

DryRun

Specifies whether to validate the request without changing the tier. Route 53 returns the same errors as for a real request, but doesn't change the hosted zone. The default is false.

Type: Boolean

Required: No

HostedZoneTier

Specify the tier to move the hosted zone to. Valid values are the following:

  • STANDARD: The default tier for new hosted zones.

  • ADVANCED: A tier that includes Change History and offers more optional features.

Type: String

Valid Values: STANDARD | ADVANCED

Required: Yes

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 Error Types.

InvalidInput

The input is not valid.

message

HTTP Status Code: 400

NoSuchHostedZone

No hosted zone exists with the ID that you specified.

message

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

See Also

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