AWS SDK Version 2 for .NET
API Reference

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.

.NET Framework 3.5
This action creates a new hosted zone.

To create a new hosted zone, send a POST request to the

            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 abstract CreateHostedZoneResponse CreateHostedZone(
         CreateHostedZoneRequest request


Type: Amazon.Route53.Model.CreateHostedZoneRequest

Container for the necessary parameters to execute the CreateHostedZone service method.

Return Value
Type: Amazon.Route53.Model.CreateHostedZoneResponse
The response from the CreateHostedZone service method, as returned by Route53.


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.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5