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.
Buckets
Los buckets son los contenedores básicos que conservan tus datos como objetos. Todo lo que almacenes en Cloud Storage debe estar contenido en un bucket. Puedes usar buckets para organizar tus datos y controlar el acceso a ellos, pero, a diferencia de los directorios y las carpetas, no puedes anidar los buckets.
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 de un bucket existente. En cambio, puedes crear un bucket nuevo con el nombre que desees 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.
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”.
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)
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.
Accede a los datos en buckets usando carpetas o directorios
Si bien Cloud Storage almacena datos no estructurados en forma de objetos, algunas funciones te permiten acceder a tus datos y administrarlos con carpetas o directorios.
Espacio de nombres jerárquico
Cuando creas buckets, puedes habilitar de forma opcional el espacio de nombres jerárquico para el bucket, lo que te permite usar carpetas para almacenar tus objetos como en un sistema de archivos. Organizar tus objetos en carpetas facilita la ejecución de operaciones en grandes cantidades de datos, lo que mejora el rendimiento, la coherencia y la facilidad de administración. Usar buckets con el espacio de nombres jerárquico habilitado es especialmente beneficioso cuando se trabaja con cargas de trabajo orientadas a archivos y con uso intensivo de datos.
Para comenzar a usar el espacio de nombres jerárquico, consulta Crea buckets con espacio de nombres jerárquico habilitado.
Cloud Storage FUSE
Cloud Storage FUSE es un adaptador de FUSE que te permite activar y acceder a los buckets como sistemas de archivos locales para que las aplicaciones puedan leer y escribir objetos en tu bucket con la semántica del sistema de archivos estándar. Cloud Storage FUSE te permite almacenar tus datos en Cloud Storage con todos los beneficios del servicio y, al mismo tiempo, conservar la capacidad de acceder a esos datos con el código de tu aplicación sin necesidad de realizar cambios.
Para aprender a usar Cloud Storage FUSE, consulta la guía de inicio rápido de Cloud Storage FUSE.
¿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.