Skip to content

AWS Route 53 API

Todd Knarr edited this page Jun 21, 2016 · 3 revisions

dnsapi.ini record template:

# AWS Route 53  API key ID              API key
route53         xxxxxxxxxxxxxxxxxxxx    xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

domains.ini record template:

# AWS Route 53                          Region      Hosted domain ID    TTL
example3.com    example3        route53 us-east-1   xxxxxxxxxxxxxx      3600

Route 53 has an XML-based RESTful API for updating resource records in a zone. Using it requires the following information:

  • Your AWS or IAM API key ID and secret key.
  • The Route53 hosted domain ID for the domain.

The API key ID and secret key should be for an IAM user authorized to update the Route 53 information, and ideally should be a user dedicated to DKIM key updating. Copy the key ID and secret key value into the route53 line in the dnsapi.ini file replacing the strings of x's.

To get the zone ID, go to the hosted zones listing in the Route 53 management console. The ID for each zone is listed on the right. This value goes into the domains.ini file replacing the string of x's on the Route 53 template entry. The region string should always be us-east-1 (Route 53 doesn't use separate regions). The TTL (time-to-live) value in seconds can be omitted in which case it defaults to 3600 (1 hour) which is want it's set to in the template entry. It's best to leave this as it is unless you have a firm understanding of how TTL affects DNS queries.

Clone this wiki locally