En esta página, se muestra cómo enumerar los objetos almacenados en tus depósitos de Cloud Storage, que están ordenados por nombre y de forma lexicográfica en la lista. Para obtener una descripción general de los depósitos y objetos, consulta los Términos clave.
Requisitos previos
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 el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con 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 el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con 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 el bucket que deseas acceder existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con 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 el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con 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.
Enumerar los objetos de un bucket
Completa los siguientes pasos para enumerar los objetos en un bucket:
Console
- En Google Cloud Console, ve a la página Navegador de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket que posee el contenido que deseas ver.
De manera opcional, usa el filtrado para reducir los resultados en la lista.
Línea de comandos
gcloud
Usa el comando gcloud alpha storage ls
con la marca --recursive
:
gcloud alpha storage ls --recursive gs://BUCKET_NAME/**
Aquí:
BUCKET_NAME
es el nombre del bucket cuyos objetos deseas incluir en una lista. Por ejemplo,my-bucket
.
La respuesta se ve como el siguiente ejemplo:
gs://my-bucket/cats.jpeg gs://my-bucket/dogs.jpeg gs://my-bucket/thesis.txt ...
gsutil
Usa el comando gsutil ls
con la marca -r
:
gsutil ls -r gs://BUCKET_NAME/**
En la que:
BUCKET_NAME
es el nombre del bucket cuyos objetos deseas incluir en una lista. Por ejemplo,my-bucket
.
La respuesta se ve como el siguiente ejemplo:
gs://my-bucket/cats.jpeg gs://my-bucket/dogs.jpeg gs://my-bucket/thesis.txt ...
Muestras de código
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.
En la siguiente muestra, se enumeran todos los objetos en un bucket:
En el siguiente ejemplo, se enumeran los objetos con un prefijo dado:
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/o"
Donde:
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del bucket cuyos objetos deseas incluir en una lista. Por ejemplo,my-bucket
.
Puedes usar un parámetro de string de consulta
prefix=PREFIX
para limitar los resultados a los objetos que tienen el prefijo especificado.
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?list-type=2"
Donde:
OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del bucket cuyos objetos deseas incluir en una lista. Por ejemplo,my-bucket
.
Puedes usar un parámetro de string de consulta
prefix=PREFIX
para limitar los resultados a los objetos que tienen el prefijo especificado.
¿Qué sigue?
- Descarga un objeto de tu bucket .
- Mira y edita metadatos de objetos.
- Borra objetos de tu depósito.
- Obtén más información sobre cómo paginar resultados.