Acerca de los buckets de Cloud Storage

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 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.

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 el bucket nuevo se crea en una ubicación diferente y dentro de los 10 minutos posteriores a la eliminación del bucket anterior, las solicitudes realizadas al bucket nuevo durante esos 10 minutos pueden 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 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.

  • 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.

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)

¿Qué sigue?