Obtén el diseño de almacenamiento de un bucket

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se describe cómo determinar el diseño de almacenamiento de tu bucket. El diseño de almacenamiento hace referencia a cómo se organizan los objetos dentro de un bucket, ya sea en un espacio de nombres plano o en un espacio de nombres jerárquico. El diseño es importante para las aplicaciones que interactúan con el bucket, ya que los métodos de acceso y manipulación de objetos varían según el diseño. El diseño de almacenamiento también incluye información acerca de la ubicación del bucket.

Con la API de getStorageLayout, tu aplicación puede adaptar su comportamiento de acuerdo con si un bucket usa o no espacios de nombres jerárquicos, lo que garantiza una compatibilidad óptima y aprovecha las funciones adecuadas según la configuración del bucket.

Funciones necesarias

Para obtener los permisos necesarios para obtener el diseño de almacenamiento de un bucket de Cloud Storage, pídele a tu administrador que te otorgue el rol de usuario de objetos de almacenamiento (roles/storage.objectUser) en el bucket.

El rol contiene el permiso storage.objects.list, que se requiere para obtener el diseño de almacenamiento del bucket.

Es posible que también puedas obtener este permiso con otros roles personalizados o roles predefinidos. Para ver qué roles están asociados con qué permisos, consulta Roles de IAM para Cloud Storage.

Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.

Obtén el diseño de almacenamiento de un bucket

Línea de comandos

Usa el comando gcloud alpha storage buckets describe con la marca --format:

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

Aquí:

• BUCKET_NAME es el nombre del bucket relevante. Por ejemplo, my-bucket.

Si se realiza de forma correcta y el espacio de nombres jerárquico está habilitado, la respuesta se verá como el ejemplo siguiente:

  hierarchicalNamespace:
    enabled: true

API de JSON

1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

2. Usa cURL para llamar a la API de JSON con una solicitud de getStorageLayout:

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

   En el que BUCKET_NAME es el nombre del bucket correspondiente. Por ejemplo, my-bucket

   Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:

     {
         "kind": "storage#storageLayout",
         "bucket": "my-bucket",
         "location": "us-central1",
         "locationType": "region",
         "hierarchicalNamespace":{enabled: true},
     }

¿Qué sigue?

• Información sobre las carpetas.
• Crea y administra carpetas.
• Cambia el nombre de las carpetas.

Pruébalo tú mismo

Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.

Probar Cloud Storage gratis