En esta página, se describen los buckets, un recurso en Cloud Storage. Para obtener una descripción general de cómo funciona Cloud Storage, consulta la descripción general del producto de Cloud Storage.
Depósitos
Los depósitos son los contenedores básicos que conservan tus datos. Todo lo que almacenes en Cloud Storage se debe contener en un bucket. Puedes usar depósitos para organizar y controlar el acceso a los datos, pero, a diferencia de los directorios y las carpetas, no puedes anidar los depósitos.
No hay límite para la cantidad de buckets que puedes tener en un proyecto o una ubicación.
- Sin embargo, existen límites para la frecuencia con la que puedes crear o borrar buckets.
Cuando crees un bucket, le otorgas un nombre único a nivel global y una ubicación geográfica en la que se almacenan el bucket y su contenido.
- No puedes cambiar el nombre ni la ubicación de un bucket existente. En cambio, puedes crear un bucket nuevo con las propiedades que deseas y mover el contenido del bucket anterior al nuevo. Consulta Mueve y cambia el nombre de los buckets para ver una guía paso a paso.
- Los precios (como los cargos por el almacenamiento de datos, el procesamiento de datos y la transferencia de datos salientes de la red) dependen de factores como la ubicación del bucket y las clases de almacenamiento de objetos que contiene. Para obtener más información, consulta los Precios de Cloud Storage.
- Puedes usar la Identity and Access Management (IAM) para controlar el acceso a depósitos individuales.
Habilita el espacio de nombres jerárquico en los buckets
Cuando creas un bucket, tienes la opción de habilitar el espacio de nombres jerárquico (vista previa) para tu bucket. Los buckets con el espacio de nombres jerárquico habilitado tienen una estructura de almacenamiento optimizada similar a un sistema de archivos, que organiza los objetos en una jerarquía de carpetas. Esto proporciona mayor rendimiento, coherencia y facilidad de administración, en especial para cargas de trabajo con uso intensivo de datos y orientadas a archivos. Para obtener información sobre cómo habilitar el espacio de nombres jerárquico, consulta Crea y administra buckets con espacio de nombres jerárquico habilitado.
Nombres de buckets
Los nombres de tu bucket deben cumplir los siguientes requisitos:
- Los nombres de los depósitos solo pueden contener letras en minúscula, caracteres numéricos, guiones (
-
), guiones bajos (_
) y puntos (.
). No se permiten espacios. Los nombres que contienen puntos se deben verificar. - Deben comenzar y terminar con un número o una letra.
- Pueden contener entre 3 y 63 caracteres. Los nombres que contienen puntos pueden contener hasta 222 caracteres, pero cada componente separado por puntos no puede tener más de 63 caracteres.
- No se pueden representar como una dirección IP en notación decimal con puntos (por ejemplo, 192.168.5.4).
- No pueden comenzar con el prefijo "goog".
- No pueden contener “google” o errores ortográficos, como “g00gle”.
Consideraciones de los nombres de depósitos
Los nombres de los buckets se encuentran en un solo espacio de nombres que comparten todos los usuarios de Cloud Storage. Esto significa que:
Cada bucket debe tener un nombre único a nivel global.
Si intentas crear un bucket con un nombre que ya pertenece a un bucket existente, como
example-bucket
, Cloud Storage responderá con un mensaje de error.Los nombres de depósitos son visibles de forma pública.
No uses ID de usuario, direcciones de correo electrónico, nombres o números de proyectos o cualquier otra información de identificación personal (PII) en los nombres de los bucket s, ya que cualquier persona puede buscar la existencia de un bucket.
Luego de borrar un bucket, cualquier persona podrá reutilizar su nombre en uno nuevo.
El tiempo que tarda el nombre de un bucket borrado en volver a estar disponible suele ser de segundos; sin embargo, ten en cuenta lo siguiente:
- Si borras el proyecto que contiene el bucket, que en este caso también borra el bucket, es posible que el nombre del bucket no esté disponible durante unas semanas o por más tiempo.
- Si se crea un bucket nuevo con el mismo nombre en una ubicación diferente y
en un plazo de 10 minutos de la eliminación del bucket anterior, las solicitudes realizadas al bucket
nuevo durante este período de 10 minutos podrían fallar con un
error
404-Bucket Not Found
. - Si tus solicitudes pasan por la API de XML, los intentos de crear un bucket que reutilice un nombre en una ubicación nueva pueden fallar con el error
404-Bucket Not Found
durante un máximo de 10 minutos después de la eliminación del bucket anterior.
Puedes usar un nombre de bucket en un registro DNS como parte de un redireccionamiento
CNAME
oA
.Para ello, el nombre del bucket debe cumplir con las convenciones de nombres de DNS estándar. Esto significa que el nombre del bucket no debe usar guiones bajos (
_
) ni tener un punto junto a otro punto o guion. Por ejemplo,..
,-.
y.-
son combinaciones de caracteres no válidas dentro de nombres de DNS.
Ejemplos de nombres de depósitos
Los siguientes son ejemplos de nombres de bucket válidos:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(requiere verificación de propiedad deexample.com
)
Los siguientes son ejemplos de nombres de depósitos no válidos:
My-Travel-Maps
(contiene letras mayúsculas)my_google_bucket
(contiene "google")test bucket
(contiene un espacio)
¿Qué sigue?
- Crea buckets de Cloud Storage.
- Renombra un depósito existente.
- Obtén más información de los metadatos asociados a un bucket.
- Sube un objeto.