Richieste REST

Le richieste REST di Amazon Route 53 sono richieste HTTPS, come definito da RFC 2616. Questa sezione descrive la struttura di una richiesta REST di Route 53.

Una tipica azione REST consiste nell'invio di una singola richiesta HTTPS a Route 53 e nell'attesa della risposta. Come ogni richiesta HTTP, una richiesta REST a Route 53 contiene un metodo di richiesta, un URI, intestazioni di richiesta e talvolta una stringa di query o il corpo della richiesta. La risposta contiene un codice di stato HTTP, intestazioni di risposta e talvolta un corpo di risposta.

URI di richiesta

L'URI della richiesta inizia sempre con una barra e quindi con la versione dell'API Route 53 utilizzata (ad esempio, 2013-04-01). La parte restante dell'URI indica la specifica risorsa su cui intendi agire. Ad esempio, di seguito è riportato l'URI utilizzato per la creazione di una nuova zona ospitata. Per ulteriori informazioni, consulta CreateHostedZone.

/2013-04-01/hostedzone

Informazioni sul Request Time Stamp

È necessario fornire il timestamp nell'intestazione HTTP o nell'Date AWS x-amz-dateintestazione (alcune librerie client HTTP non consentono di impostare l'intestazione). Date Quando un'intestazione x-amz-date è presente, il sistema ignora qualsiasi intestazione Date all'autenticazione della richiesta.

Il timestamp deve essere compreso tra 5 minuti e l'ora di AWS sistema in cui viene ricevuta la richiesta. In caso contrario, la richiesta non riesce e viene restituito il codice di errore RequestExpired. In questo modo, si impediscono riproduzioni delle tue richieste da parte di un antagonista.

La data deve essere specificata nel formato ISO 8601, ad esempio. 2016-03-03T19:20:25.177Z Per ulteriori informazioni sul formato ISO 8601, consulta l'articolo di Wikipedia ISO 8601.

Corpo della richiesta

Molte delle azioni dell'API Route 53 richiedono l'inclusione di XML nel corpo della richiesta. L'XML è conforme allo schema Route 53.

POST /2013-04-01/hostedzone HTTP/1.1
host:route53.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
[Other required headers]
		
<?xml version="1.0" encoding="UTF-8"?>
<CreateHostedZoneRequest xmlns="https://route53.amazonaws.com/
doc/2013-04-01/">
   <Name>example.com.</Name>
   <CallerReference>myUniqueIdentifier</CallerReference>
   <HostedZoneConfig>
      <Comment>This is my hosted zone.</Comment>
   </HostedZoneConfig>
</CreateHostedZoneRequest>