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:
Temas
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-
. -
Los nombres de los buckets no deben comenzar con el prefijo
sthree-configurator
. -
Los nombres de los buckets no deben comenzar con el prefijo
amzn-s3-demo-
. -
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 no deben terminar con el sufijo
.mrap
. Este sufijo está reservado para nombres de punto de acceso de varias regiones. Para obtener más información, consulte Reglas para asignar nombres a los puntos de acceso de varias regiones de Amazon S3. -
Los nombres de los buckets no deben terminar con el sufijo
--x-s3
. Este sufijo está reservado para buckets de directorio. Para obtener más información, consulte Reglas de nomenclatura de buckets de directorio. -
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) yaws-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
Las siguientes reglas de nomenclatura se aplican a los buckets de directorio.
-
Ser únicos dentro de la Región de AWS y la zona de disponibilidad elegida.
-
El nombre debe tener entre 3 (mín.) y 63 caracteres (máx.), 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 -
Los nombres de los buckets no deben comenzar con el prefijo
xn--
. -
Los nombres de los buckets no deben comenzar con el prefijo
sthree-
. -
Los nombres de los buckets no deben comenzar con el prefijo
sthree-configurator
. -
Los nombres de los buckets no deben comenzar con el prefijo
amzn-s3-demo-
. -
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 no deben terminar con el sufijo
.mrap
. Este sufijo está reservado para nombres de punto de acceso de varias regiones. Para obtener más información, consulte Reglas para asignar nombres a los puntos de acceso de varias regiones de Amazon S3.
nota
Al crear un bucket de directorio mediante la consola, se agrega 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 directorio 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.