Reglas de nomenclatura de buckets - Amazon Simple Storage Service

Reglas de nomenclatura de buckets

Las siguientes reglas se aplican a la nomenclatura de buckets de uso general y buckets de directorio en Amazon S3:

Reglas de nomenclatura de los buckets de uso general

Las siguientes reglas de nomenclatura se aplican para buckets de uso general.

  • Los nombres de bucket deben tener entre 3 caracteres (mín.) y 63 caracteres (máx.).

  • Los nombres de bucket pueden consistir únicamente de letras minúsculas, números, puntos (.) y guiones (-).

  • Los nombres de bucket deben comenzar y terminar con una letra o un número.

  • Los nombres de bucket no deben contener dos puntos adyacentes.

  • Los nombres de buckets no deben tener el formato de una dirección IP (por ejemplo, 192.168.5.4).

  • Los nombres de los buckets no deben comenzar con el prefijo xn--.

  • Los nombres de los buckets no deben comenzar con el prefijo sthree- ni el prefijo sthree-configurator.

  • Los nombres de los buckets no deben terminar con el sufijo -s3alias. Este sufijo está reservado para nombres de alias de punto de acceso. Para obtener más información, consulte Uso de un alias de estilo de bucket para su punto de acceso de bucket de S3.

  • Los nombres de los buckets no deben terminar con el sufijo --ol-s3. Este sufijo está reservado para nombres de alias de punto de acceso de Object Lambda. Para obtener más información, consulte Cómo usar un alias de estilo de bucket para su punto de acceso de Object Lambda de bucket de S3.

  • Los nombres de los buckets deben ser únicos en todas las Cuentas de AWS de todas las Regiones de AWS de una partición. Una partición es una agrupación de regiones. AWS actualmente tiene tres particiones: aws (regiones estándar), aws-cn (regiones de China) y aws-us-gov (AWS GovCloud (US)).

  • Otra Cuenta de AWS de la misma partición no puede utilizar el mismo nombre de bucket hasta que se elimine el bucket.

  • Los buckets utilizados con Amazon S3 Transfer Acceleration no pueden tener puntos (.) en sus nombres. Para obtener más información acerca de Transfer Acceleration, consulte Configuración de transferencias de archivos rápidas y seguras con Amazon S3 Transfer Acceleration.

Para obtener una mejor compatibilidad, se recomienda evitar el uso de puntos (.) en los nombres de los buckets, excepto para los buckets que se utilizan únicamente para el alojamiento estático de sitios web. Si incluye puntos en el nombre de un bucket, no puede usar direccionamiento de estilo host virtual a través de HTTPS, a menos que realice su propia validación de certificado. Esto se debe a que los certificados de seguridad utilizados para el alojamiento virtual de los buckets no funcionan para los buckets con puntos en sus nombres.

Esta limitación no afecta a los buckets utilizados para el alojamiento de sitios web estáticos, ya que el alojamiento de sitios web estáticos solo está disponible a través de HTTP. Para obtener más información acerca del direccionamiento de tipo de host virtual, consulte Alojamiento virtual de buckets. Para obtener más información sobre el alojamiento estático de sitios web, consulte Alojamiento de un sitio web estático mediante Amazon S3.

nota

Antes del 1 de marzo de 2018, los buckets creados en la región EE. UU. Este (Norte de Virginia) podían tener nombres de hasta 255 caracteres e incluir letras mayúsculas y guiones bajos. A partir del 1 de marzo de 2018, los nuevos buckets de EE. UU. Este (Norte de Virginia) deben ajustarse a las mismas reglas aplicadas en todas las demás regiones.

Para obtener información acerca de los nombres de clave de objeto, consulte Creación de nombres de clave de objeto.

Nombres de buckets de uso general de ejemplo

Los nombres de bucket de ejemplo siguientes son válidos y siguen las pautas de nomenclatura recomendadas para buckets de uso general:

  • docexamplebucket1

  • log-delivery-march-2020

  • my-hosted-content

Los nombres de bucket de ejemplo siguientes son válidos pero no se recomiendan para usos distintos del alojamiento estático de sitios web:

  • docexamplewebsite.com

  • www.docexamplewebsite.com

  • my.example.s3.bucket

Los nombres de bucket de ejemplo siguientes no son válidos:

  • doc_example_bucket (contiene guiones bajos)

  • DocExampleBucket (contiene letras mayúsculas)

  • doc-example-bucket- (termina con un guion)

Reglas de nomenclatura de buckets de directorio

Los nombres de los buckets de directorio deben:

  • Ser únicos dentro de la Región de AWS y la zona de disponibilidad elegida.

  • No tener más de 3 a 63 caracteres, incluido el sufijo.

  • Constar de letras minúsculas, números y guiones (-).

  • Comenzar y terminar por un número o una letra.

  • Debe incluir el siguiente sufijo: --azid--x-s3.

nota

Al crear un bucket de directorios mediante la consola, se añade automáticamente un sufijo al nombre base que proporcione. Este sufijo incluye el ID de zona de disponibilidad de la que haya elegido.

Al crear un bucket de directorios mediante una API, en la solicitud debe proporcionar el sufijo completo, incluido el ID de la zona de disponibilidad. Para obtener una lista de los ID de las zonas de disponibilidad, consulte Zonas y regiones de disponibilidad de S3 Express One Zone.