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/hostedzone
resource. The request body must include a document
with a CreateHostedZoneRequest element. The response returns the CreateHostedZoneResponse
element 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 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, you could specify an optional DelegationSetId, and Route53 would assign those 4 NS records for the zone, instead of alloting a new one.
Namespace: Amazon.Route53
Assembly: AWSSDK.dll
Version: (assembly version)
public virtual CreateHostedZoneResponse CreateHostedZone( CreateHostedZoneRequest request )
Container for the necessary parameters to execute the CreateHostedZone service method.
| Exception | Condition |
|---|---|
| ConflictingDomainExistsException | |
| 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. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5