

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Solicitações de REST
<a name="api-requests-rest-overview"></a>

As solicitações REST do Amazon Route 53 são solicitações HTTPS, conforme definido pela [RFC 2616](https://www.ietf.org/rfc/rfc2616.txt). Esta seção descreve a estrutura de uma solicitação REST do Route 53. 

Uma ação REST típica consiste em enviar uma única solicitação HTTPS para o Route 53 e aguardar a resposta. Como qualquer solicitação HTTP, uma solicitação REST para o Route 53 contém um método de solicitação, um URI, cabeçalhos de solicitação e, às vezes, uma string de consulta ou corpo da solicitação. A resposta contém um código de status HTTP, cabeçalhos de resposta e, às vezes, corpo da resposta.

## URI da solicitação
<a name="api-requests-rest-uri"></a>

O URI da solicitação sempre começa com uma barra e depois com a versão da API do Route 53 que você usa (por exemplo, 2013-04-01). O restante do URI indica o recurso específico que você deseja utilizar. Por exemplo, a seguir está o URI que você usa ao criar uma nova zona hospedada. (Para ter mais informações, consulte [CreateHostedZone](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateHostedZone.html).)

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

## Sobre o carimbo de data/hora da solicitação
<a name="api-requests-rest-time-stamp"></a>

Você deve fornecer o carimbo de data/hora no `Date` cabeçalho HTTP ou no AWS `x-amz-date` cabeçalho (algumas bibliotecas de cliente HTTP não permitem que você defina o `Date` cabeçalho). Quando existe um cabeçalho `x-amz-date`, o sistema ignora qualquer cabeçalho `Date` ao autenticar a solicitação.

O registro de data e hora deve estar dentro de 5 minutos da hora do AWS sistema quando a solicitação é recebida. Caso negativo, haverá falha na solicitação com o código de erro `RequestExpired`. Isso visa impedir reproduções de suas solicitações por um adversário.

A data deve ser especificada no formato ISO 8601, por exemplo,. `2016-03-03T19:20:25.177Z` Para obter mais informações sobre o formato ISO 8601, consulte o artigo da Wikipédia [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

## Corpo da Solicitação
<a name="api-requests-rest-body"></a>

Muitas das ações da API do Route 53 exigem que você inclua XML no corpo da solicitação. O XML está em conformidade com o esquema do Route 53. 

**Example Exemplo de solicitação**  
*O exemplo de solicitação a seguir usa uma instrução XML simples para criar uma zona hospedada chamada example.com com o identificador de referência my. UniqueIdentifier*  
Os elementos XML em sua solicitação devem aparecer na ordem listada.  

```
 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>
```