Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Las solicitudes REST de Amazon Route 53 son solicitudes HTTPS, según se define en el [RFC 2616](https://www.ietf.org/rfc/rfc2616.txt). En esta sección se describe la estructura de una solicitud REST de Route 53. 

Una acción REST típica consiste en enviar una sola solicitud HTTPS a Route 53 y esperar la respuesta. Como cualquier solicitud HTTP, una solicitud REST a Route 53 contiene un método de solicitud, un URI, encabezados de solicitud y, a veces, una cadena de consulta o un cuerpo de solicitud. La respuesta contiene un código de estado HTTP, encabezados de respuesta y, a veces, una respuesta.

## URI de solicitud
<a name="api-requests-rest-uri"></a>

El URI de la solicitud siempre comienza con una barra diagonal y, a continuación, con la versión de la API de Route 53 que utilices (por ejemplo, 2013-04-01). El resto de la URI indica el recurso concreto sobre el que desea actuar. Por ejemplo, a continuación se muestra el URI que se utiliza al crear una nueva zona alojada. (Para obtener más información, consulte [CreateHostedZone](https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateHostedZone.html)).

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

## Acerca de la marca de tiempo de la solicitud
<a name="api-requests-rest-time-stamp"></a>

Debe proporcionar la marca de tiempo en el `Date` encabezado HTTP o en el AWS `x-amz-date` encabezado (algunas bibliotecas cliente HTTP no permiten configurar el `Date` encabezado). Cuando hay un encabezado `x-amz-date` presente, el sistema hace caso omiso de cualquier encabezado `Date` al autenticar la solicitud.

La marca de tiempo debe estar a menos de 5 minutos de la hora AWS del sistema en que se reciba la solicitud. En caso contrario, ocurrirá un error en la solicitud y recibirá el código de error `RequestExpired`. Esta medida evita repeticiones de sus solicitudes por parte de un adversario.

La fecha debe especificarse en formato ISO 8601, por ejemplo,`2016-03-03T19:20:25.177Z`. Para obtener más información acerca del formato ISO 8601, consulte el artículo de Wikipedia [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

## Cuerpo de la solicitud
<a name="api-requests-rest-body"></a>

Muchas de las acciones de la API de Route 53 requieren que incluya XML en el cuerpo de la solicitud. El XML se ajusta al esquema de Route 53. 

**Example Solicitud de ejemplo**  
*El siguiente ejemplo de solicitud usa una instrucción XML simple para crear una zona hospedada llamada example.com con el identificador de referencia, my. UniqueIdentifier*  
Los elementos XML de la solicitud deben aparecer en el orden indicado.  

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