View definition

(*Route53).CreateHostedZone

Defined in github.com/aws/aws-sdk-go/service/route53/api.go

Description

Creates a new public hosted zone, used to specify how the Domain Name System (DNS) routes traffic on the Internet for a domain, such as example.com, and its subdomains.

Public hosted zones cannot be converted to a private hosted zone or vice

versa. Instead, create a new hosted zone with the same name and create new resource record sets.

Send a POST request to the /Amazon Route 53 API version/hostedzone resource.

The request body must include an XML document with a CreateHostedZoneRequest element. The response returns the CreateHostedZoneResponse element containing metadata about the hosted zone.

Fore more information about charges for hosted zones, see AmazonAmazon Route 53 Pricing (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/pricing/).

Note the following:

You cannot create a hosted zone for a top-level domain (TLD).

Amazon Route 53 automatically creates a default SOA record and four NS

records for the zone. For more information about SOA and NS records, see NS and SOA Records that Amazon Route 53 Creates for a Hosted Zone (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/SOA-NSrecords.html) in the Amazon Route 53 Developer Guide.

If your domain is registered with a registrar other than Amazon Route

53, you must update the name servers with your registrar to make Amazon Route 53 your DNS service. For more information, see Configuring Amazon Route 53 as your DNS Service (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/creating-migrating.html) in the Amazon Route 53 Developer's Guide.

After creating 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 INSYNC 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, specify an optional DelegationSetId, and Amazon Route 53 would assign those 4 NS records for the zone, instead of alloting a new one.