En esta página, se muestra cómo obtener información sobre el tamaño y los metadatos de tus buckets de Cloud Storage.
Permisos necesarios
Consola
Para completar esta guía con la consola de Google Cloud, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
A fin de obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para la consola de Google Cloud.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Línea de comandos
Para completar esta guía con una utilidad de línea de comandos, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para los comandos de gsutil.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Bibliotecas cliente
Para completar esta guía con las bibliotecas cliente de Cloud Storage, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
A menos que se indique lo contrario, las solicitudes de la biblioteca cliente se realizan mediante la API de JSON y requieren permisos, como se indica en Permisos de IAM para métodos de JSON. Para ver qué métodos de la API de JSON se invocan cuando realizas solicitudes mediante una biblioteca cliente, registra las solicitudes sin procesar.
Para obtener una lista de los roles de IAM relevantes, consulta Roles de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
API de REST
API de JSON
Para completar esta guía con la API de JSON, debes tener los permisos de IAM adecuados. Si no creaste el bucket al que deseas acceder, es posible que el propietario del proyecto te otorgue una función que contenga los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Determina el tamaño de un bucket
Console
Si quieres usar el Explorador de métricas para ver las métricas de un recurso supervisado, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Explorador de métricas en Monitoring.
- En el panel Seleccionar una métrica, expande el menú Métrica, ingresa
Total bytes
en la barra de filtros y, luego, usa los submenús para seleccionar un métrica y tipo de recurso específicos:- En el menú Recursos activos, selecciona Bucket de GCS.
- En el menú Categorías de métricas activas, selecciona Almacenamiento.
- En el menú Métricas activas, selecciona Bytes en total.
- Haga clic en Apply.
- Opcional: Para configurar cómo se ven los datos, agrega filtros, agrupaciones y configura los campos de alineación. De forma predeterminada, el Explorador de métricas agrega una agrupación que promedia todas las series temporales:
- Para agrupar series temporales por etiquetas de recursos o métricas, expande el menú Etiquetas en la sección Agrupar por y, luego, realiza tus selecciones. También puedes cambiar la función de agrupación.
- Para ver todas las series temporales, en la entrada Agrupar por, haz clic en deleteBorrar.
- Para acceder a los campos de alineación, haz clic en Más opciones.
- Opcional: Cambia la configuración en el panel Visualización:
- Para obtener cuotas y otras métricas que informen una muestra por día, establece el Tipo de widget como Gráfico de barras apiladas.
- Para las métricas con valor de distribución, establece el Tipo de widget como Gráfico de mapa de calor.
- Opcional: Para obtener cuotas y otras métricas que informen una muestra por día, establece el período en al menos una semana.
También puedes usar el Explorador de métricas para medir otras métricas del depósito, como storage.googleapis.com/storage/object_count y storage.googleapis.com/storage/total_byte_seconds, que miden la cantidad diaria de objetos y el almacenamiento diario que se usó, respectivamente. Consulta la documentación de métricas de Google Cloud para obtener una lista completa de las métricas disponibles, y visita Métricas, series temporales y recursos a fin de obtener más información sobre el uso del Explorador de métricas.
Línea de comandos
Usa el comando gsutil du
con una marca -s
:
gsutil du -s gs://BUCKET_NAME
Donde BUCKET_NAME
es el nombre del depósito relevante.
La respuesta se ve como el siguiente ejemplo:
134620 gs://my-bucket
En este ejemplo, el tamaño del depósito my-bucket
es de 134,620 bytes.
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 siguiente comando gsutil ls
:
gsutil ls -L -b gs://BUCKET_NAME
Donde BUCKET_NAME
es el nombre del depósito relevante.
La respuesta se ve como el siguiente ejemplo:
gs://my-bucket/ : Storage class: STANDARD Location type: multi-region Location constraint: US ...
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
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de JSON con una solicitud de bucketGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Aquí:
OAUTH2_TOKEN
es el nombre del token de acceso que generaste en el paso 1.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 OAUTH2_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,location
ystorageClass
.
La respuesta se ve como el siguiente ejemplo:
{ "location": "US", "storageClass": "STANDARD" }
API de XML
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de XML con una solicitud de bucketGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
En el ejemplo anterior, se ilustra lo siguiente:
OAUTH2_TOKEN
es el nombre del token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.QUERY_PARAMETER
es el campo de metadatos que deseas mostrar. Por ejemplo,location
para obtener la ubicación del depósito. 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:
<LocationConstraint>US</LocationConstraint>
.
¿Qué sigue?
- Consulta la descripción general de los metadatos de depósitos.
- Enumera objetos.
- Obtén metadatos de objetos
- Cambia la clase de almacenamiento predeterminada de un depósito.
- Obtén más información sobre la supervisión de tus recursos en Monitoring.
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