Strumento gsutil

gsutil è un'applicazione Python che ti consente di accedere a Cloud Storage dalla riga di comando. Puoi utilizzare gsutil per eseguire un'ampia gamma di attività di gestione di bucket e oggetti, tra cui:

  • Creazione ed eliminazione di bucket.
  • Caricamento, download ed eliminazione di oggetti.
  • Elenco di bucket e oggetti.
  • Spostamento, copia e ridenominazione di oggetti.
  • Modifica degli ACL di oggetti e bucket.

gsutil esegue tutte le operazioni, inclusi caricamenti e download, utilizzando HTTPS e TLS (Transport Layer Security).

Dovresti usare gsutil?

In genere, è consigliabile utilizzare i comandi gcloud storage anziché i comandi gsutil:

  • Lo strumento gsutil è un'interfaccia a riga di comando legacy di Cloud Storage ed è stato sottoposto a manutenzione minima.

  • Lo strumento gsutil non supporta l'utilizzo delle nuove funzionalità di Cloud Storage, come l'eliminazione temporanea e le cartelle gestite.

  • I comandi gcloud storage richiedono meno ottimizzazioni manuali per ottenere le velocità di caricamento e download più rapide.

Migrazione a gcloud CLI

Se sei un utente gsutil e vuoi eseguire la migrazione a gcloud CLI, devi prima verificare se stai utilizzando una versione autonoma di gsutil eseguendo il seguente comando:

gsutil version -l

  • Se il risultato del comando include using cloud sdk: False, significa che stai utilizzando una versione autonoma di gsutil. Per eseguire la migrazione a gcloud CLI, inizia installando gcloud CLI.

  • Se il risultato del comando include using cloud sdk: True, l'interfaccia alla gcloud CLI è già installata.

Una volta installata gcloud CLI, puoi utilizzare i comandi gcloud storage come faresti con i comandi gsutil. Le seguenti risorse possono aiutarti a iniziare:

Sintassi per l'accesso alle risorse

gsutil utilizza il prefisso gs:// per indicare una risorsa in Cloud Storage:

gs://BUCKET_NAME/OBJECT_NAME

Oltre a specificare le risorse esatte, gsutil supporta l'utilizzo di caratteri jolly nei comandi.

Guida integrata

gsutil contiene una guida integrata completa per ogni comando e una serie di argomenti, che puoi elencare e leggere con il comando gsutil help.

Per ottenere informazioni su un comando o un argomento specifico, utilizza gsutil help seguito dal nome del comando o dell'argomento desiderato. Ad esempio, gsutil help cp e gsutil help options sono rispettivamente una pagina della guida per i comandi e una pagina della guida relativa agli argomenti.

Per ricevere informazioni sull'installazione di gsutil, utilizza il comando gsutil version:

gsutil version -l

Statistiche sull'utilizzo

Durante la procedura di installazione, puoi attivare il monitoraggio delle statistiche sull'utilizzo, che aiuta a migliorare lo strumento gsutil. Se in seguito decidi di disattivare queste statistiche sull'utilizzo, consulta Statistiche sull'utilizzo.

Informazioni su gsutil

gsutil è un progetto open source. Per scaricare la versione per sviluppatori di gsutil o per aiutarti a sviluppare gsutil, visita il progetto gsutil su GitHub.

Limitazioni

  • Quando si utilizza gsutil con Windows, i comandi che utilizzano il flag globale -m non possono essere annullati utilizzando Ctrl-C.

Passaggi successivi