Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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.
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:
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 otra persona reutiliza el nombre de tu bucket, no podrás restablecer el bucket borrado, incluso si tiene habilitada la eliminación no definitiva.
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.
Si alguien reutiliza el nombre de tu bucket, podría recibir sin querer datos o solicitudes destinados a tu bucket original borrado. Para mitigar este riesgo, considera las siguientes prácticas recomendadas:
Cuando crees buckets, usa una convención de nomenclatura sólida que no sea fácil de adivinar o predecir.
Cuando borres buckets, asegúrate de quitar todas las referencias al nombre del bucket borrado, como de la documentación externa o de los repositorios de código abierto.
Si ya no necesitas un bucket, considera vaciar todos los objetos del bucket y conservarlo en lugar de borrarlo.
Puedes usar un nombre de bucket en un registro DNS como parte de un redireccionamiento CNAME o A.
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.
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[],[],null,["# About Cloud Storage buckets\n\nThis page describes buckets, a resource in Cloud Storage. For a general\noverview of how Cloud Storage works, see the\n[Cloud Storage product overview](/storage/docs/introduction).\n\nBuckets\n-------\n\nBuckets are the basic containers that hold your data as [objects](/storage/docs/objects).\nEverything that you store in Cloud Storage must be contained in a\nbucket. You can use buckets to organize your data and control access to your\ndata, but unlike directories and folders, you cannot nest buckets.\n\n- There is no limit to the number of buckets you can have in a project or\n [location](/storage/docs/locations).\n\n - There are, however, [limits to the rate you can create or delete buckets](/storage/quotas).\n- When you [create a bucket](/storage/docs/creating-buckets), you give it a [globally-unique name](#naming) and a\n [geographic location](/storage/docs/locations) where the bucket and its contents are stored.\n\n - You cannot change the name of an existing bucket. Instead, you can create a new bucket with the name you want and move the contents from the old bucket to the new bucket. See [Move and rename buckets](/storage/docs/moving-buckets) for a step-by-step guide.\n\n\u003c!-- --\u003e\n\n- Pricing (such as charges for data storage, data processing, and network outbound data transfer) depends on factors such as the bucket's location and the storage classes of objects within it. For more details, see [Cloud Storage pricing](/storage/pricing).\n\n\u003c!-- --\u003e\n\n- You can use [Identity and Access Management (IAM)](/storage/docs/access-control/iam) to control access to individual buckets.\n\nBucket names\n------------\n\nYour bucket names must meet the following requirements:\n\n- Bucket names can only contain lowercase letters, numeric characters, dashes (`-`), underscores (`_`), and dots (`.`). Spaces are not allowed. Names containing dots require [verification](/storage/docs/domain-name-verification).\n- Bucket names must start and end with a number or letter.\n- Bucket names must contain 3-63 characters. Names containing dots can contain up to 222 characters, but each dot-separated component can be no longer than 63 characters.\n- Bucket names cannot be represented as an IP address in dotted-decimal notation (for example, 192.168.5.4).\n- Bucket names cannot begin with the \"goog\" prefix.\n- Bucket names cannot contain \"google\" or close misspellings, such as \"g00gle\".\n\n### Example bucket names\n\nThe following are examples of valid bucket names:\n\n- `my-travel-maps`\n- `0f75d593-8e7b-4418-a5ba-cb2970f0b91e`\n- `test.example.com` (Requires [verification of ownership for `example.com`](/storage/docs/domain-name-verification))\n\nThe following are examples of invalid bucket names:\n\n- `My-Travel-Maps` (contains uppercase letters)\n- `my_google_bucket` (contains \"google\")\n- `test bucket` (contains a space)\n\n### Bucket name considerations\n\n- Bucket names reside in a single namespace that is shared by all\n Cloud Storage users. This means that:\n\n - Every bucket name must be globally unique.\n\n If you try to create a bucket with a name that already belongs to an\n existing bucket, such as `example-bucket`, Cloud Storage\n responds with an error message.\n - Bucket names are publicly visible.\n\n Don't use user IDs, email addresses, project names, project numbers, or\n any personally identifiable information (PII) in bucket names because\n anyone can probe for the existence of a bucket.\n- Once you delete a bucket, anyone can reuse its name for a new bucket.\n\n - The time it takes a deleted bucket's name to become available again is\n typically on the order of seconds; however, keep in mind the following:\n\n - If you delete the project that contains the bucket, which effectively\n deletes the bucket as well, the bucket name may not be released for weeks\n or longer.\n\n - If someone reuses your bucket's name, you cannot restore your deleted\n bucket even if the bucket has soft delete enabled.\n\n - If a new bucket with the same name is created in a different location and\n within 10 minutes of the old bucket's deletion, requests made to the new\n bucket during this 10 minute timeframe might fail with a\n `404-Bucket Not Found` error.\n\n - If your requests go through the [XML API](/storage/docs/xml-api), attempts to create a bucket\n that reuses a name in a new location might fail with a\n `404-Bucket Not Found` error for up to 10 minutes after the old bucket's\n deletion.\n\n - If someone reuses your bucket's name, they could inadvertently\n receive data or requests intended for your original deleted bucket. To\n mitigate this risk, consider the following best practices:\n\n - When creating buckets, use a strong naming convention that's not easy to\n guess or predict.\n\n - When deleting buckets, make sure to remove all references of the\n deleted bucket's name, such as from external documentation or open\n source repositories.\n\n - If you no longer need a bucket, consider emptying all objects from\n the bucket and keeping the bucket instead of deleting it.\n\n- You can use a bucket name in a DNS record as part of a `CNAME` or `A`\n redirect.\n\n In order to do so, your bucket name should conform to standard DNS naming\n conventions. This means that your bucket name shouldn't use underscores\n (`_`) or have a period next to another period or dash. For example, `..`,\n `-.`, and `.-` are invalid character combinations within DNS names.\n\nAccess data in buckets by using folders or directories\n------------------------------------------------------\n\nAlthough Cloud Storage stores unstructured data in the form of objects,\nsome features let you access and manage your data using folders or directories.\n\n### Hierarchical namespace\n\nWhen you create buckets, you can optionally enable [hierarchical namespace](/storage/docs/hns-overview)\nfor the bucket, which lets you use [folders](/storage/docs/folders-overview) to store your objects in\na file system manner. Organizing your objects into folders makes it easier to\nrun operations on large scales of data, improving performance, consistency,\nand ease of management. Using buckets with hierarchical namespace enabled is\nespecially beneficial when working with data-intensive and file-oriented\nworkloads.\n\nTo get started using hierarchical namespace, see\n[Create buckets with hierarchical namespace enabled](/storage/docs/create-hns-bucket).\n\n### Cloud Storage FUSE\n\n[Cloud Storage FUSE](/storage/docs/cloud-storage-fuse/overview#overview) is a FUSE adapter that lets you mount and access buckets as\nlocal file systems, so applications can read and write objects in your bucket\nusing standard file system semantics. Cloud Storage FUSE lets you store your data\nin Cloud Storage with all the service's benefits, all while retaining\nthe ability to access that data using your application's code without needing\nchanges.\n\nTo learn how to use Cloud Storage FUSE, see the [Cloud Storage FUSE quickstart](/storage/docs/cloud-storage-fuse/quickstart-mount-bucket).\n\nWhat's next\n-----------\n\n- [Create Cloud Storage buckets](/storage/docs/creating-buckets).\n- [Rename an existing bucket](/storage/docs/moving-buckets).\n- Learn about the [metadata associated with a bucket](/storage/docs/bucket-metadata).\n- [Upload an object](/storage/docs/uploading-objects)."]]
