En esta página, se muestra cómo enumerar los buckets de Cloud Storage de un proyecto, que están ordenados en la lista de forma lexicográfica por nombre.
Antes de comenzar
Para obtener los permisos que necesitas a fin de crear una lista de buckets, pídele a tu administrador que te otorgue el rol de administrador de almacenamiento (roles/storage.admin
) o el rol básico de visualizador (roles/viewer
) en el proyecto que contiene el proyecto los buckets que deseas enumerar.
Para obtener más información sobre cómo otorgar roles para proyectos, consulta Administra el acceso a los proyectos.
Los roles contienen el permiso storage.buckets.list
, que se requiere para enumerar buckets. También puedes obtener este permiso con roles personalizados.
Enumera los buckets de un proyecto
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
Los buckets que forman parte del proyecto que se encuentra seleccionado aparecen en la lista.
De manera opcional, usa filtrado y ordenamiento para limitar y organizar los resultados en tu lista.
Línea de comandos
-
En la consola de Google Cloud, activa Cloud Shell.
En la parte inferior de la consola de Google Cloud, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
En tu entorno de desarrollo, ejecuta el comando
gcloud storage ls
:gcloud storage ls
La respuesta se ve como el siguiente ejemplo:
gs://BUCKET_NAME1/ gs://BUCKET_NAME2/ gs://BUCKET_NAME3/ ...
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.
APIs 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 para enumerar buckets:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Cuando
PROJECT_IDENTIFIER
es el ID o el número del proyecto que contiene los buckets que deseas enumerar. Por ejemplo,my-project
.
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 servicioGET
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com"
Cuando
PROJECT_ID
es el ID del proyecto que contiene los buckets que deseas enumerar. Por ejemplo,my-project
¿Qué sigue?
- Obtén información sobre el tamaño de un bucket.
- Enumera los objetos de un bucket.
- Mueve o cambia el nombre de un depósito.
- Borra un bucket.
- Obtén más información sobre cómo paginar resultados.