En esta página, se muestra cómo obtener información sobre los metadatos de tus buckets de Cloud Storage, sin incluir las políticas de IAM y las LCA.
Para obtener información sobre cómo obtener la política de IAM de tu bucket, consulta Visualiza la política de IAM de un bucket.
Roles obligatorios
Para obtener los permisos necesarios para obtener los metadatos de un bucket de Cloud Storage, pídele a tu administrador que te otorgue el rol Administrador de almacenamiento (roles/storage.admin
) en el bucket.
Este rol contiene los permisos necesarios para obtener los metadatos de un bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:
Permisos necesarios
storage.buckets.get
storage.buckets.list
- Este permiso solo es necesario si planeas usar la consola de Google Cloud para realizar la tarea en esta página.
También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.
Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.
Muestra los metadatos de un bucket
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket cuyos metadatos deseas ver.
Haz clic en la pestaña Configuración para ver los detalles del bucket, como las regiones incluidas, la clase de almacenamiento, los permisos y el tipo de replicación.
Línea de comandos
Usa el comando gcloud storage buckets describe
:
gcloud storage buckets describe gs://BUCKET_NAME
Donde:
BUCKET_NAME
es el nombre del bucket cuyos metadatos deseas ver. Por ejemplo,my-awesome-bucket
Si se realiza de forma correcta, la respuesta se verá como el ejemplo siguiente:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Terraform
Puedes usar un recurso de Terraform para ver los metadatos de un bucket.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Usa
cURL
para llamar a la API de JSON con una solicitud de bucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
En el que
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.De forma opcional, puedes limitar los resultados de los metadatos mediante el parámetro de string de consulta
fields
. Por ejemplo:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
En el ejemplo anterior,
FIELD#
es una propiedad de depósito que deseas incluir en el resultado. Por ejemplo,projectNumber
ystorageClass
.
La respuesta se ve como el siguiente ejemplo:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
API de XML
Tener la gcloud CLI instalada e inicializadaa fin de generar un token de acceso para el encabezado
Authorization
.Como alternativa, puedes crear un token de acceso con OAuth 2.0 Playground y, luego, incluirlo en el encabezado
Authorization
.Usa
cURL
para llamar a la API de XML con una solicitud de bucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
Donde:
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.QUERY_PARAMETER
es el campo de metadatos que deseas mostrar. Por ejemplo,storageClass
para obtener la clase de almacenamiento del bucket. Solo puedes usar un parámetro de búsqueda a la vez con la API de XML. Para obtener una lista de los campos de metadatos que admite la API de XML, consulta la página de referencia del bucketGET
.
La respuesta se ve como el siguiente ejemplo:
<StorageClass>STANDARD</StorageClass>
.
¿Qué sigue?
- Consulta la descripción general de los metadatos de depósitos.
- Enumera objetos.
- Obtén el tamaño de tu bucket.
- Obtén metadatos de objetos
- Cambia la clase de almacenamiento predeterminada de un depósito.
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 y, además, implementar cargas de trabajo.
Probar Cloud Storage gratis