Amazon Route 53
API Reference

RPC Requests

Amazon Route 53 RPC requests are HTTPS requests, as defined by RFC 2616 (for more information, go to This section describes the structure of an Amazon Route 53 RPC request.

For an RPC action, you send an HTTPS request to Amazon Route 53 and wait for the response. An RPC request to Amazon Route 53 contains request headers and sometimes a query string or request body. The response contains an HTTP status code, response headers, and sometimes a response body.

About the Request Time Stamp

You must provide the time stamp in either the HTTP Date header or the AWS x-amz-date header (some HTTP client libraries don't let you set the Date header). When an x-amz-date header is present, the system ignores any Date header when authenticating the request.

The time stamp must be within 5 minutes of the AWS system time when the request is received. If it isn't, the request fails with the RequestExpired error code. This is to prevent replays of your requests by an adversary.

The date must be specified in ISO 8601 format, for example, 2016-03-03T19:20:25.177Z. For more information about ISO 8601 format, see the Wikipedia article ISO 8601.

Request Body

Many of the Amazon Route 53 API actions require you to include JSON in the body of the request. The JSON conforms to the Amazon Route 53 schema for domain registration.

Example Request

The following example request uses a simple JSON statement to determine whether the domain name is available.

The JSON elements in your request must appear in the order listed.

POST / HTTP/1.1 x-amz-date:date and time of the request authorization:AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/date of the request in yyyymmdd format/us-east-1/route53domains/aws4_request, SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target, Signature=computed signature x-amz-target:Route53Domains_v20140515.CheckDomainAvailability user-agent:information about the source of the request content-type:application/x-amz-json- 1.1 content-length:length connections:Keep-Alive { "DomainName":"" }