Obtener el diseño de almacenamiento de un segmento

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página se describe cómo determinar el diseño del almacenamiento de un cubo. El diseño del almacenamiento hace referencia a cómo se organizan los objetos en un segmento, 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 contenedor, ya que los métodos de acceso y manipulación de objetos varían en función del diseño. El diseño del almacenamiento también incluye información sobre la ubicación del contenedor.

Al usar la API getStorageLayout, tu aplicación puede adaptar su comportamiento en función de si un contenedor usa un espacio de nombres jerárquico o no, lo que garantiza una compatibilidad óptima y aprovecha las funciones adecuadas según la configuración del contenedor.

Roles necesarios

Para obtener los permisos necesarios para obtener el diseño de almacenamiento de un segmento de Cloud Storage , pide a tu administrador que te conceda el rol Usuario de objetos de Storage (roles/storage.objectUser) en el segmento.

El rol contiene el permiso storage.objects.list, que es necesario para obtener el diseño de almacenamiento del segmento.

También puedes obtener este permiso con otros roles personalizados o roles predefinidos. Para ver qué roles están asociados a qué permisos, consulta Roles de gestión de identidades y accesos de Cloud Storage.

Para obtener instrucciones sobre cómo conceder roles en los contenedores, consulta el artículo Usar gestión de identidades y accesos con contenedores.

Obtener el diseño de almacenamiento de un segmento

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)"

Donde:

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

Si la operación se realiza correctamente y el espacio de nombres jerárquico está habilitado, la respuesta será similar al siguiente ejemplo:

  hierarchicalNamespace:
    enabled: true

API JSON

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

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

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

   Donde BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

   Si la acción se realiza correctamente, la respuesta se parecerá al siguiente ejemplo:

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

Siguientes pasos

• Información sobre las carpetas
• Crea y gestiona carpetas.
• Cambiar el nombre de las carpetas.

Pruébalo

Si es la primera vez que utilizas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito gratuito para ejecutar, probar y desplegar cargas de trabajo.

Probar Cloud Storage gratis