AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
To create a new hosted zone, send a
POST request to the
/Route 53 API version/hostedzoneresource. The request body must include a document with a
CreateHostedZoneRequestelement. The response returns the
CreateHostedZoneResponseelement that contains metadata about the hosted zone.
Amazon Route 53 automatically creates a default SOA record and four NS records for the zone. The NS records in the hosted zone are the name servers you give your registrar to delegate your domain to. For more information about SOA and NS records, see NS and SOA Records that Amazon Route 53 Creates for a Hosted Zone in the Amazon Route 53 Developer Guide.
When you create a zone, its initial status is
PENDING. This means that
it is not yet available on all DNS servers. The status of the zone changes to
when the NS and SOA records are available on all Amazon Route 53 DNS servers.
When trying to create a hosted zone using a reusable delegation set, you could specify an optional DelegationSetId, and Route53 would assign those 4 NS records for the zone, instead of alloting a new one.
Version: (assembly version)
public virtual CreateHostedZoneResponse CreateHostedZone( CreateHostedZoneRequest request )
Container for the necessary parameters to execute the CreateHostedZone service method.
|DelegationSetNotAvailableException||Amazon Route 53 allows some duplicate domain names, but there is a maximum number of duplicate names. This error indicates that you have reached that maximum. If you want to create another hosted zone with the same name and Amazon Route 53 generates this error, you can request an increase to the limit on the Contact Us page.|
|DelegationSetNotReusableException||The specified delegation set has not been marked as reusable.|
|HostedZoneAlreadyExistsException||The hosted zone you are trying to create already exists. Amazon Route 53 returns this error when a hosted zone has already been created with the specified CallerReference.|
|InvalidDomainNameException||This error indicates that the specified domain name is not valid.|
|InvalidInputException||Some value specified in the request is invalid or the XML document is malformed.|
|InvalidVPCIdException||The hosted zone you are trying to create for your VPC_ID does not belong to you. Amazon Route 53 returns this error when the VPC specified by VPCId does not belong to you.|
|NoSuchDelegationSetException||The specified delegation set does not exist.|
|TooManyHostedZonesException||This error indicates that you've reached the maximum number of hosted zones that can be created for the current AWS account. You can request an increase to the limit on the Contact Us page.|
Supported in: 4.5, 4.0, 3.5