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:
Explora los comandos de
gcloud storage
con la guía de inicio rápido Descubre el almacenamiento de objetos con la herramienta de gcloud.Lee la referencia de
gcloud storage
.Revisa el corrector de compatibilidad para ejecutar
gcloud storage
, que documenta la funcionalidad que no está disponible en los comandosgcloud storage
.
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 cp
gsutil 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-C
marca global-m
no se pueden cancelar con .
¿Qué sigue?
- Instala gsutil.
- Consulta la discusión de la comunidad en las preguntas sobre Stack Overflow de gsutil.