

# Realizar solicitudes con la API REST
<a name="RESTAPI"></a>

Esta sección incluye información acerca de cómo realizar solicitudes a los puntos de enlace de Amazon S3 con la API REST. Para ver una lista de los puntos de conexión de Amazon S3, consulte [Regiones y puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/s3.html) en la *Referencia general de AWS*.

## Crear nombres de host de S3 para solicitudes de la API REST
<a name="constructing-hostname-rest-api-requests"></a>

Los puntos de enlace de Amazon S3 siguen la estructura que se muestra a continuación:

```
s3.{{Region}}.amazonaws.com
```

Los puntos de enlace de puntos de acceso de Amazon S3 y los puntos de enlace de doble pila también siguen la estructura estándar:
+ **Puntos de acceso de Amazon S** ‐`s3-accesspoint.{{Region}}.amazonaws.com`
+ **Doble pila** ‐ `s3.dualstack.{{Region}}.amazonaws.com` 

Para obtener una lista completa de las regiones y los puntos de conexión de Amazon S3, consulte [Puntos de conexión y cuotas de Amazon S3](https://docs.aws.amazon.com/general/latest/gr/s3.html) en la *Referencia general de Amazon Web Services*.

## Solicitudes de tipo alojamiento virtual y de tipo ruta
<a name="virtual-hosted-path-style-requests"></a>

Cuando realiza solicitudes con la API REST, puede utilizar los URI de tipo alojamiento virtual o tipo ruta para los puntos de enlace de Amazon S3. Para obtener más información, consulte [Solicitudes de tipo ruta](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access).

**Example Solicitud de tipo alojamiento virtual**  
A continuación, se muestra un ejemplo de una solicitud de tipo alojamiento virtual para eliminar el archivo `puppy.jpg` del bucket denominado `examplebucket` en la región EE. UU. Oeste (Oregón). Para obtener más información acerca de las solicitudes de tipo alojamiento virtual, consulte [Solicitudes de tipo ruta](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access).   

```
1. DELETE /puppy.jpg HTTP/1.1
2. Host: examplebucket.s3.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```

**Example Solicitud de tipo ruta**  
A continuación se muestra un ejemplo de una versión tipo ruta de la misma solicitud.  

```
1. DELETE /examplebucket/puppy.jpg HTTP/1.1
2. Host: s3.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```
Actualmente, Amazon S3 admite URL tanto de tipo host virtual como de tipo ruta en todas las Regiones de AWS. Sin embargo, las URL de tipo ruta dejarán de usarse en el futuro. Para obtener más información, consulte la siguiente nota **Importante**.  
Para obtener más información acerca de las solicitudes de tipo ruta, consulte [Solicitudes de tipo ruta](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access).  
Actualización (23 de septiembre de 2020): para garantizar que los clientes tienen el tiempo necesario para pasar a las URL de tipo host virtual, hemos decidido retrasar la obsolescencia de las URL de tipo ruta. Para obtener más información, consulte [Amazon S3 Path Deprecation Plan – The Rest of the Story](https://aws.amazon.com/blogs/aws/amazon-s3-path-deprecation-plan-the-rest-of-the-story/) en el *Blog de noticias de AWS*.

## Realizar solicitudes a los puntos de enlace de doble pila con la API REST
<a name="rest-api-dual-stack"></a>

Cuando utiliza la API REST, puede acceder directamente al punto de enlace de doble pila con un nombre de punto de enlace de tipo alojamiento virtual o tipo ruta (URI). Todos los nombres de punto de enlace de doble pila de Amazon S3 incluyen la región en el nombre. A diferencia de los puntos de enlace estándar que solo admiten IPv4, tanto los puntos de enlace de tipo alojamiento virtual como los de tipo ruta utilizan nombres de puntos de enlace específicos de la región. 

**Example Solicitud de punto de enlace de doble pila de tipo alojamiento virtual**  
Puede utilizar un punto de enlace de tipo alojamiento virtual en su solicitud REST como se muestra en el siguiente ejemplo, que recupera el objeto `puppy.jpg` del bucket denominado `examplebucket` en la región EE. UU. Oeste (Oregón).   

```
1. GET /puppy.jpg HTTP/1.1
2. Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```

**Example Solicitud de punto de enlace de doble pila de tipo ruta**  
O bien, puede utilizar un punto de enlace de tipo ruta en su solicitud como se muestra en el siguiente ejemplo.   

```
1. GET /examplebucket/puppy.jpg HTTP/1.1
2. Host: s3.dualstack.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```

Para obtener más información acerca de los puntos de enlace de doble pila, consulte [Uso de puntos de conexión de doble pila en Amazon S3](dual-stack-endpoints.md). 

Para obtener más información acerca de cómo realizar solicitudes mediante la API de REST, consulte los temas siguientes.

**Topics**
+ [Crear nombres de host de S3 para solicitudes de la API REST](#constructing-hostname-rest-api-requests)
+ [Solicitudes de tipo alojamiento virtual y de tipo ruta](#virtual-hosted-path-style-requests)
+ [Realizar solicitudes a los puntos de enlace de doble pila con la API REST](#rest-api-dual-stack)
+ [Solicitar redireccionamiento y la API REST](RESTRedirect.md)
+ [Enrutamiento de solicitudes](UsingRouting.md)