AWS SDK Version 3 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.

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

You can't convert a public hosted zones to a private hosted zone or vice versa. Instead, you must create a new hosted zone with the same name and create new resource record sets.

For more information about charges for hosted zones, see Amazon Route 53 Pricing.

Note the following:

When you submit a CreateHostedZone request, the initial status of the hosted zone is PENDING. This means that the NS and SOA records are not yet available on all Amazon Route 53 DNS servers. When the NS and SOA records are available, the status of the zone changes to INSYNC.


For PCL this operation is only available in asynchronous form. Please refer to CreateHostedZoneAsync.

Namespace: Amazon.Route53
Assembly: AWSSDK.Route53.dll
Version: 3.x.y.z


public virtual CreateHostedZoneResponse CreateHostedZone(
         CreateHostedZoneRequest request
Type: Amazon.Route53.Model.CreateHostedZoneRequest

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

Return Value
The response from the CreateHostedZone service method, as returned by Route53.


ConflictingDomainExistsException The cause of this error depends on whether you're trying to create a public or a private hosted zone: Public hosted zone: Two hosted zones that have the same name or that have a parent/child relationship ( and can't have any common name servers. You tried to create a hosted zone that has the same name as an existing hosted zone or that's the parent or child of an existing hosted zone, and you specified a delegation set that shares one or more name servers with the existing hosted zone. Private hosted zone: You specified an Amazon VPC that you're already using for another hosted zone, and the domain that you specified for one of the hosted zones is a subdomain of the domain that you specified for the other hosted zone. For example, you can't use the same Amazon VPC for the hosted zones for and
DelegationSetNotAvailableException You can create a hosted zone that has the same name as an existing hosted zone ( is common), but there is a limit to the number of hosted zones that have the same name. If you get this error, Amazon Route 53 has reached that limit. If you own the domain name and Amazon Route 53 generates this error, contact Customer Support.
DelegationSetNotReusableException A reusable delegation set with the specified ID does not exist.
HostedZoneAlreadyExistsException The hosted zone you're trying to create already exists. Amazon Route 53 returns this error when a hosted zone has already been created with the specified CallerReference.
InvalidDomainNameException The specified domain name is not valid.
InvalidInputException The input is not valid.
InvalidVPCIdException The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access this VPC.
NoSuchDelegationSetException A reusable delegation set with the specified ID does not exist.
TooManyHostedZonesException This hosted zone can't be created because the hosted zone limit is exceeded. To request a limit increase, go to the Amazon Route 53 Contact Us page.


This example shows how to create an Amazon Route 53 hosted zone and add a resource record set to the zone.

Create a hosted zone and add a resource record set

string domainName = "";

IAmazonRoute53 route53Client = new AmazonRoute53Client();

CreateHostedZoneRequest zoneRequest = new CreateHostedZoneRequest
  Name = domainName,
  CallerReference = "my_change_request"

CreateHostedZoneResponse zoneResponse = route53Client.CreateHostedZone(zoneRequest);

ResourceRecordSet recordSet = new ResourceRecordSet
  Name = domainName,
  TTL = 60,
  Type = RRType.A,
  ResourceRecords = new List { new ResourceRecord { Value = "" } }

Change change1 = new Change
  ResourceRecordSet = recordSet,
  Action = ChangeAction.CREATE

ChangeBatch changeBatch = new ChangeBatch
  Changes = new List { change1 }

ChangeResourceRecordSetsRequest recordsetRequest = new ChangeResourceRecordSetsRequest
  HostedZoneId = zoneResponse.HostedZone.Id,
  ChangeBatch = changeBatch

ChangeResourceRecordSetsResponse recordsetResponse = route53Client.ChangeResourceRecordSets(recordsetRequest);

GetChangeRequest changeRequest = new GetChangeRequest
  Id = recordsetResponse.ChangeInfo.Id

while (route53Client.GetChange(changeRequest).ChangeInfo.Status == ChangeStatus.PENDING)
  Console.WriteLine("Change is pending.");

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also