View a markdown version of this page

Solicitações de REST - Amazon Route 53
URI da solicitaçãoSobre o carimbo de data/hora da solicitaçãoCorpo da Solicitação

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

As solicitações REST do Amazon Route 53 são solicitações HTTPS, conforme definido pela RFC 2616. 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

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.)

/2013-04-01/hostedzone

Sobre o carimbo de data/hora da solicitação

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.

Corpo da Solicitação

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.

exemplo 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.

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>