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 una amplia gama de tareas de gestión de segmentos y objetos, como las siguientes:

  • crear y eliminar depósitos,
  • subir, descargar y eliminar objetos,
  • consultar depósitos y objetos,
  • desplazar y copiar objetos y cambiarles el nombre,
  • Editar las LCAs de objetos y segmentos.

gsutil realiza todas las operaciones, incluidas las subidas y descargas, mediante HTTPS y Seguridad en la capa de transporte (TLS).

¿Deberías usar gsutil?

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

  • La herramienta gsutil es una CLI antigua de Cloud Storage que se mantiene de forma mínima.

  • La herramienta gsutil no admite el uso de las funciones más recientes de Cloud Storage, como la eliminación lógica y las carpetas gestionadas.

  • Los comandos gcloud storage requieren menos optimización manual para conseguir las velocidades de subida y descarga más rápidas.

Migrar a la CLI de gcloud

Si usas gsutil y quieres migrar a la CLI de gcloud, primero debes comprobar si estás usando una versión independiente de gsutil ejecutando el siguiente comando:

gsutil version -l

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

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

Una vez instalada la CLI de gcloud, puedes usar los comandos de gcloud storage de la misma forma que los comandos de gsutil. Los siguientes recursos pueden ayudarte a empezar:

Sintaxis para acceder a los recursos

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

gs://BUCKET_NAME/OBJECT_NAME

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

Acceder a una lista de archivos

En las operaciones que implican un gran número de archivos, puede transferir una lista de archivos de origen a gsutil mediante la marca -I. De esta forma, gsutil lee la lista de archivos o URLs de objetos de stdin en lugar de los argumentos de la línea de comandos.

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

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 archivo de example_file_list.txt y las copian en un segmento 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 sobre la marcha y enviarla directamente a gsutil. Por ejemplo, los siguientes comandos suben todos los archivos JPG que se encuentran en el directorio actual y los copian en gs://example-destination-bucket:

find . -name "*.jpg" | gsutil -m cp -I gs://example-destination-bucket

Ayuda integrada

gsutil incluye una ayuda detallada sobre cada comando, así como varios temas, que puedes consultar con el comando gsutil help.

Para obtener información sobre un comando o un tema concretos, usa gsutil help seguido del nombre del comando o del tema. Por ejemplo, gsutil help cp y gsutil help options son una página de ayuda de un comando y una página de ayuda de un tema, respectivamente.

Para obtener información sobre tu instalación de gsutil, usa el comando gsutil version:

gsutil version -l

Estadísticas de uso

Durante el proceso de instalación, puedes habilitar el seguimiento de las estadísticas de uso, lo que ayuda a mejorar la herramienta gsutil. Si más adelante decides inhabilitar estas estadísticas de uso, consulta Estadísticas de uso.

Acerca de gsutil

gsutil es un proyecto de código abierto. Para descargar la versión para desarrolladores de gsutil o colaborar en el desarrollo de gsutil, visita el proyecto gsutil en GitHub.

Limitaciones

  • Cuando se usa gsutil con Windows, los comandos que usan la marca global -m no se pueden cancelar con Ctrl-C.

Siguientes pasos