En esta página, se muestra cómo obtener información sobre el tamaño y los metadatos de tus buckets de Cloud Storage.
Prerequisites
Los requisitos previos pueden variar según la herramienta que se use:
Consola
Para completar esta guía con Google Cloud Console, 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 Google Cloud Console.
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.
Muestras de código
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.
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.
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 Google Cloud Console, ve a la página Explorador de métricas en Monitoring.
- En la barra de herramientas, selecciona la pestaña Explorador.
- Selecciona la pestaña Configuración.
- Expande el menú Seleccionar una métrica, ingresa
Total bytes
en la barra de filtros y, luego, usa los submenús para seleccionar una métrica y un 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 visualizan los datos, agrega filtros y usa los menús Agrupar por, Agregador y tipo de gráfico. Por ejemplo, puedes agrupar por etiquetas de recursos o métricas. Para obtener más información, consulta Selecciona métricas cuando uses el Explorador de métricas.
- Opcional: Cambia la configuración del gráfico:
- Para obtener cuotas y otras métricas que informen una muestra por día, establece el período en al menos una semana y el tipo de trazado en Gráfico de barras apiladas.
- Para las métricas con valor de distribución, establece el tipo de trazado en Gráfico de mapa de calor.
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.
Opcional: Puedes limitar la cantidad de columnas que aparecen en la lista de depósitos de la consola de Google Cloud. Para ello, haz clic en el menú Opciones de visualización de columnas ().
En la lista de bucket s, busca el bucket que deseas verificar y revisa los encabezados de columna para ver los metadatos que deseas.
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 constraint: US ...
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
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
.
Limita los resultados a los campos que desees mediante los parámetros de búsqueda:
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.
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.
- Cambia la clase de almacenamiento predeterminada de un depósito.
- Usa etiquetas de 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