Métodos para acceder a un bucket

Para obtener acceso a su bucket puede usar la consola de Amazon S3. Con la User Interface (UI, Interfaz de usuario) de la consola, puede realizar prácticamente todas las operaciones en el bucket sin tener que escribir ningún código.

Si obtiene acceso a un bucket mediante programación, Amazon S3 admite la arquitectura RESTful en la que los buckets y objetos son recursos, cada uno con un URI (Identificador uniforme de recursos) mediante el cual se identifica específicamente el recurso.

Amazon S3 admite URL tanto de tipo alojamiento virtual como de tipo ruta para obtener acceso a un bucket. Debido a que se puede obtener acceso a los buckets mediante los URL de tipo ruta y alojamiento virtual, le recomendamos crear buckets con nombres de buckets compatibles con DNS. Para obtener más información, consulte Restricciones y limitaciones de los buckets.

nota

Las solicitudes de tipo host virtual y de tipo ruta utilizan la estructura de punto de enlace S3 punto región (s3.Region), por ejemplo, https://my-bucket.s3.us-west-2.amazonaws.com. Sin embargo, algunas regiones más antiguas de Amazon S3 también admiten puntos de enlace de S3 guión región s3-Region, por ejemplo, https://my-bucket.s3-us-west-2.amazonaws.com. Si el bucket se encuentra en una de estas regiones, es posible que vea puntos de enlace de s3-Region en los registros de acceso al servidor o en los registros de AWS CloudTrail. Le recomendamos que no utilice esta estructura de punto de enlace en sus solicitudes.

Acceso al tipo host virtual

En una solicitud de tipo alojamiento virtual, el nombre del bucket forma parte del nombre del dominio en la URL.

Las URL de tipo host virtual de Amazon S3 utilizan el siguiente formato:

https://bucket-name.s3.region-code.amazonaws.com/key-name

En este ejemplo, DOC-EXAMPLE-BUCKET1 es el nombre del bucket, EE.UU Oeste (Oregon) es la región y puppy.png es el nombre clave:

https://DOC-EXAMPLE-BUCKET1.s3.us-west-2.amazonaws.com/puppy.png

Para obtener más información acerca de las solicitudes de tipo alojamiento virtual, consulte Solicitudes de tipo host virtual.

Acceso de tipo ruta

En Amazon S3, las URL de tipo ruta utilizan el siguiente formato:

https://s3.region-code.amazonaws.com/bucket-name/key-name

Por ejemplo, si crea un bucket con el nombre DOC-EXAMPLE-BUCKET1 en la región EE. UU. Oeste (Oregón) y quiere acceder al objeto puppy.jpg en dicho bucket, puede usar la siguiente URL de tipo ruta:

https://s3.us-west-2.amazonaws.com/DOC-EXAMPLE-BUCKET1/puppy.jpg

Para obtener más información, 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 en el Blog de noticias de AWS.

Acceder a un bucket de S3 a través de IPv6

Amazon S3 tiene un conjunto de puntos de enlace de doble stack que admite solicitudes a los buckets de S3 mediante Internet Protocol versión 6 (IPv6) e IPv4. Para obtener más información, consulte Realizar solicitudes mediante IPv6.

Acceso a un bucket a través de los puntos de acceso de S3

Además de acceder de forma directa, puede acceder a un bucket a través de un punto de acceso. Para obtener más información acerca de la función de puntos de acceso de S3, consulte Administración del acceso a datos con puntos de acceso de Amazon S3.

Los puntos de acceso de S3 solo admiten el direccionamiento de tipo host virtual. Para direccionar un bucket a través de un punto de acceso, utilice el siguiente formato.

https://AccessPointName-AccountId.s3-accesspoint.region.amazonaws.com.

nota

• Si el nombre del punto de acceso incluye caracteres de guion (-), incluya los guiones en la URL e inserte otro guion antes del ID de cuenta. Por ejemplo, para utilizar un punto de acceso denominado finance-docs propiedad de la cuenta 123456789012 en la región us-west-2, la dirección URL apropiada sería https://finance-docs-123456789012.s3-accesspoint.us-west-2.amazonaws.com.

• Los puntos de acceso de S3 no admiten el acceso por HTTP, solo el acceso seguro por HTTPS.

Acceso a un bucket mediante S3://

Algunos servicios de AWS requieren especificar un bucket de Amazon S3 mediante S3://bucket. En el siguiente ejemplo se muestra el formato correcto. Tenga en cuenta que cuando se utiliza este formato, el nombre del bucket no incluye la Región de AWS.

S3://bucket-name/key-name

Por ejemplo, en el siguiente ejemplo se utiliza el bucket de muestra descrito en la sección anterior de tipo de ruta.

S3://mybucket/puppy.jpg