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 | ADVANCEDRequired: 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: