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.

Ayuda integrada

gsutil incluye ayuda integrada completa sobre todos los comandos y una variedad de temas, que puedes obtener y leer con el comando gsutil help.

Para obtener información sobre un comando o un tema específicos, usa gsutil help seguido del comando o el nombre del tema deseados. Por ejemplo, gsutil help cpgsutil help options y son una página de ayuda sobre comandos y un tema, respectivamente.

Para obtener información sobre la instalación de gsutil, usa el comando de versión de gsutil:

gsutil version -l

Estadísticas de uso

Durante el proceso de instalación, puedes aceptar realizar un seguimiento de las estadísticas de uso, lo que ayuda a mejorar la herramienta de gsutil. Si posteriormente decides que quieres inhabilitar estas estadísticas de uso, consulta Estadísticas de uso.

Acerca de gsutil

gsutil es un proyecto de código abierto. Si deseas descargar la versión para desarrolladores de gsutil o deseas ofrecer tu ayuda en su desarrollo, visita el proyecto gsutil en GitHub.

Limitaciones

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

¿Qué sigue?