Herramienta gsutil

gsutil es una aplicación de Python que te permite acceder a Cloud Storage desde la línea de comandos. Puedes usar gsutil para realizar las siguientes tareas de administración de objetos y depósitos:

  • Crear y borrar depósitos.
  • Subir, descargar y borrar objetos
  • Crear listas de depósitos y objetos
  • Mover, copiar y cambiar nombres de objetos
  • Editar LCA de objetos y depósitos

Todas las operaciones las realiza gsutil, incluidas las cargas y descargas, mediante HTTPS y seguridad de la capa de transporte (TLS).

¿Deberías usar gsutil?

Por lo general, debes usar los comandos de gcloud storage en lugar de los comandos de gsutil:

  • La herramienta gsutil es una CLI de Cloud Storage heredada y de mantenimiento mínimo.

  • La herramienta gsutil no admite el trabajo con funciones más recientes de Cloud Storage, como borrar de forma no definitiva y carpetas administradas.

  • Los comandos gcloud storage requieren menos optimización manual para lograr las tasas de carga y descarga más rápidas.

Migra a la CLI de gcloud

Si eres un usuario de gsutil que deseas migrar a la gcloud CLI, primero debes verificar si usas una versión independiente de gsutil mediante la ejecución del siguiente comando:

gsutil version -l

  • Si el resultado del comando incluye using cloud sdk: False, estás usando una versión independiente de gsutil. Para migrar a gcloud CLI, primero debes instalar gcloud CLI.

  • Si el resultado del comando incluye using cloud sdk: True, ya tienes instalada gcloud CLI.

Una vez instalada gcloud CLI, puedes usar los comandos de gcloud storage del mismo modo que usas los comandos de gsutil. Los siguientes recursos pueden ayudarte a comenzar:

Sintaxis para acceder a los recursos

gsutil usa el prefijo gs:// para indicar un recurso en Cloud Storage:

gs://BUCKET_NAME/OBJECT_NAME

Además de especificar los recursos exactos, gsutil admite el uso de comodines en tus comandos.

Cómo acceder a una lista de archivos

Para las operaciones que involucran una gran cantidad de archivos, puedes pasar una lista de archivos fuente a gsutil con la marca -I. Esto le indica a gsutil que lea la lista de archivos o URLs de objetos desde stdin en lugar de los argumentos de la línea de comandos.

La entrada debe ser una lista de rutas de acceso a archivos locales o URLs de objetos de Cloud Storage, con una ruta de acceso por línea. Por ejemplo, puedes crear un archivo llamado example_file_list.txt que contenga las siguientes rutas de acceso:

gs://example-source-bucket/data-01.csv
gs://example-source-bucket/images/logo.png
/local/logs/error_log_20251226.txt

Los siguientes comandos de ejemplo leen las rutas de acceso a los archivos de example_file_list.txt y las copian en un bucket de destino llamado gs://example-destination-bucket:

cat example_file_list.txt | gsutil -m cp -I gs://example-destination-bucket/

También puedes generar la lista de rutas de acceso sobre la marcha y canalizarla directamente a gsutil. Por ejemplo, los siguientes comandos suben todos los archivos JPG que se encuentran en tu directorio actual y los copian en gs://example-destination-bucket:

find . -name