Amazon Route 53
Developer Guide (API Version 2012-12-12)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Getting the Name Servers for a Hosted Zone

When you create a hosted zone, Route 53 assigns four name servers to your hosted zone; these four name servers are called the delegation set. To ensure that the Domain Name System routes queries for your domain to the Route 53 name servers, update your registrar's or your DNS service's NS records for the domain to replace the current name servers with the names of the four Route 53 name servers in the delegation set for your hosted zone. The method that you use to update the NS records depends on which registrar or DNS service you're using.

You can get the name servers in the delegation set for a hosted zone using the Route 53 console or using the GET GetHostedZone API action. See the applicable topic:

Getting Name Servers Using the Route 53 Console

To get the name servers in the delegation set for a hosted zone using the Route 53 console

  1. Sign in to the AWS Management Console and open the Amazon Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the Route 53 console, click the row for the hosted zone for which you want to display name servers.

    The Delegation Set field in the right pane lists the name servers that Route 53 assigned to the hosted zone when you created it. Update your registrar's or your DNS service's NS records with the names of these name servers.

    Creating a hosted zone: tooltip for Domain Name.

Getting Name Servers Using the Route 53 API

To get the name servers in the delegation set for a hosted zone, you use the GetHostedZone API action to send a GET request to the 2012-12-12/hostedzone/<hosted zone ID> resource. The name servers that Route 53 assigned to the hosted zone when you created it are listed in the DelegationSet element of the response. For more information about the GetHostedZone API action, see GET GetHostedZone in the Amazon Route 53 API Reference.

Note

For information about using the Route 53 API, see Making API Requests. For information about calling the Route 53 API using the Route 53 dnscurl.pl utility, see Example: Using dnscurl.pl.

Example Request

GET /2012-12-12/hostedzone/Z1PA6795UKMFR9

The delegation set containing your name servers is shown in the following example response.

Example Response

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<GetHostedZoneResponse xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
   <HostedZone>
      <Id>/hostedzone/Z1PA6795UKMFR9</Id>
      <Name>example.com.</Name>
      <CallerReference>myUniqueIdentifier</CallerReference>
      <Config>
         <Comment>This is my first hosted zone.</Comment>
      </Config>
      <ResourceRecordSetCount>17</ResourceRecordSetCount>
   </HostedZone>
   <DelegationSet>
      <NameServers>
         <NameServer>ns-2048.awsdns-64.com</NameServer>
         <NameServer>ns-2049.awsdns-65.net</NameServer>
         <NameServer>ns-2050.awsdns-66.org</NameServer>
         <NameServer>ns-2051.awsdns-67.co.uk</NameServer>
      </NameServers>
   </DelegationSet>
</GetHostedZoneResponse>