Menu
Amazon Route 53
API Reference (API Version 2013-04-01)

Welcome

Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web service. Amazon Route 53 performs three main functions:

  • Domain registration – Amazon Route 53 helps lets you register domain names such as example.com.

  • Domain Name System (DNS) service – Amazon Route 53 translates friendly domains names like www.example.com into IP addresses like 192.0.2.1. Amazon Route 53 responds to DNS queries using a global network of authoritative DNS servers, which reduces latency.

  • Health checking – Amazon Route 53 sends automated requests over the Internet to your application to verify that it's reachable, available, and functional.

This Amazon Route 53 API Reference explains how to use API actions to create the following resources:

Public Hosted Zones

A public hosted zone is a container that holds information about how you want to route traffic on the Internet for a domain, such as example.com, and its subdomains. For more information, see Actions on Public Hosted Zones.

Private Hosted Zones

A private hosted zone is a container that holds information about how you want to route traffic for a domain and its subdomains within one or more Amazon Virtual Private Clouds (Amazon VPCs). For more information, see Actions on Private Hosted Zones.

Reusable Delegation Sets

By default, each hosted zone that you create gets a different set of four name servers—a different delegation set. If you create a lot of hosted zones, maintaining different delegation sets can be difficult and time consuming. Amazon Route 53 lets you create a delegation set that you can reuse with multiple hosted zones. For more information, see Actions on Reusable Delegation Sets.

Resource Record Sets

After you create a hosted zone for your domain, such as example.com, you create resource record sets to tell the Domain Name System (DNS) how to route traffic for that domain. For more information, see Actions on Resource Record Sets.

Traffic Policies and Traffic Policy Instances

You can create complex routing configurations, known as traffic policies, that use weighted, latency, failover, and geolocation resource record sets. You can then associate a traffic policy with a domain name or subdomain name, such as www.example.com, by creating a traffic policy instance. When users submit DNS queries for the domain or subdomain, Amazon Route 53 responds based on the traffic policy that you used to create the traffic policy instance. For more information, see Actions on Traffic Policies and Traffic Policy Instances.

Health Checks

Amazon Route 53 health checks monitor the health and performance of your web applications, web servers, and other resources. At regular intervals that you specify, Amazon Route 53 submits automated requests over the Internet to your application, server, or other resource to verify that it's reachable, available, and functional. For more information, see Actions on HealthChecks.

Domain Registrations

When you want to get a new domain name, such as example.com, you can register it with Amazon Route 53. You can also transfer the registration for existing domains from other registrars to Amazon Route 53. For more information, see Actions on Domain Registrations.

Tags

A tag is a label that you assign to an AWS resource. Each tag consists of a key and a value, both of which you define. You can use tags for a variety of purposes; one common use is to categorize and track your Amazon Route 53 costs. For more information, see Actions on Tags for Hosted Zones and Health Checks and Actions on Tags for Domains.

In addition, the Amazon Route 53 API Reference includes the following information:

  • Making API Requests – How to submit HTTP requests to Amazon Route 53

  • Common Headers – HTTP headers that you use to submit requests to Amazon Route 53

  • Common Errors – HTTP 4xx and 5xx status codes that Amazon Route 53 can return

For information about Amazon Route 53 concepts and about how to use the Amazon Route 53 console, see the Amazon Route 53 Developer Guide.