Realizar solicitudes con la API REST
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 en la Referencia general de AWS.
Crear nombres de host de S3 para solicitudes de la API REST
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 en la Referencia general de Amazon Web Services.
Solicitudes de tipo alojamiento virtual y de tipo ruta
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 Alojamiento virtual de buckets.
ejemplo 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 estilo de alojamiento virtual, consulte Solicitudes de tipo host virtual.
DELETE /puppy.jpg HTTP/1.1 Host: examplebucket.s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
ejemplo Solicitud de tipo ruta
A continuación se muestra un ejemplo de una versión tipo ruta de la misma solicitud.
DELETE /examplebucket/puppy.jpg HTTP/1.1 Host: s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT 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.
importante
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
Realizar solicitudes a los puntos de enlace de doble pila con la API REST
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.
ejemplo 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).
GET /puppy.jpg HTTP/1.1 Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
ejemplo 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.
GET /examplebucket/puppy.jpg HTTP/1.1 Host: s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT 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.
Para obtener más información acerca de cómo realizar solicitudes mediante la API REST, consulte los temas siguientes.
