Amazon Route 53
API Reference

RPC Responses

Amazon Route 53 responses are just standard HTTP responses. Some of the Route 53 actions return special information specific to Route 53 in the form of an HTTP header or JSON in the body of the response. The specific details are covered in the API reference topic for the particular action.

Each response contains a request ID that you can use if you need to troubleshoot a request with Route 53. The ID is contained in an HTTP header called x-amz-request-id. An example of a request ID is 647cd254-e0d1-44a9-af61-1d6d86ea6b77.

The following example shows a response to a request to create a hosted zone. The CreatedHostedZoneResponse element contains information about the hosted zone including an Route 53 identifier, the domain that the hosted zone is associated with, and a reference description and comment. The change request itself is associated with a submittal time, an identifier and a status, shown as PENDING. Most importantly, the CreatedHostedZoneResponse includes the Route 53 name servers assigned to the hosted zone; this information is contained in the DelegationSet element.

Example Response

HTTP/1.1 200 Content-Length:number of characters in the JSON string { "OperationId":"308c56712-faa4-40fe-94c8-b423069de3f6" }

Error Responses

If an RPC request results in an error, the HTTP response has:

  • An error document in JSON format as the response body

  • Content-Type header: text/xml

  • An appropriate 3xx, 4xx, or 5xx HTTP status code

Following is an example of the JSON error document in an RPC error response.

{ "__type": "", "message": "The security token included in the request is invalid." }

On this page: