RPC Requests

Amazon Route 53 RPC requests are HTTPS requests, as defined by RFC 2616 (for more information, go to http://www.ietf.org/rfc/rfc2616.txt). This section describes the structure of an Route 53 RPC request.

For an RPC action, you send an HTTPS request to Route 53 and wait for the response. An RPC request to 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 helps prevent someone else from resubmitting a request.

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

Request Body

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

Example Request

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

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

POST / HTTP/1.1  
host:route53domains.us-east-1.amazonaws.com
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":"example.com"
}