Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Richieste REST
<a name="api-requests-rest-overview"></a>

Le richieste REST di Amazon Route 53 sono richieste HTTPS, come definito da [RFC 2616](https://www.ietf.org/rfc/rfc2616.txt). 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
<a name="api-requests-rest-uri"></a>

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](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateHostedZone.html).

```
1. /2013-04-01/hostedzone
```

## Informazioni sul Request Time Stamp
<a name="api-requests-rest-time-stamp"></a>

È necessario fornire il timestamp nell'intestazione HTTP o nell'`Date` AWS `x-amz-date`intestazione (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](https://en.wikipedia.org/wiki/ISO_8601).

## Corpo della richiesta
<a name="api-requests-rest-body"></a>

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

**Example Richiesta di esempio**  
*La seguente richiesta di esempio utilizza una semplice istruzione XML per creare una zona ospitata denominata example.com con l'identificatore di riferimento my. UniqueIdentifier*  
Gli elementi XML della richiesta devono apparire nell'ordine elencato.  

```
 1. POST /2013-04-01/hostedzone HTTP/1.1
 2. host:route53.amazonaws.com
 3. x-amz-date:{{date and time of the request}}
 4. authorization:AWS4-HMAC-SHA256
 5.               Credential=AKIAIOSFODNN7EXAMPLE/{{date of the request in yyyymmdd format}}/us-east-1/route53domains/aws4_request,
 6.               SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
 7.               Signature={{computed signature}}
 8. {{[Other required headers]}}
 9. 		
10. <?xml version="1.0" encoding="UTF-8"?>
11. <CreateHostedZoneRequest xmlns="https://route53.amazonaws.com/
12. doc/2013-04-01/">
13.    <Name>{{example.com.}}</Name>
14.    <CallerReference>{{myUniqueIdentifier}}</CallerReference>
15.    <HostedZoneConfig>
16.       <Comment>{{This is my hosted zone.}}</Comment>
17.    </HostedZoneConfig>
18. </CreateHostedZoneRequest>
```