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 dei bucket.
  • Caricamento, download ed eliminazione di oggetti.
  • Elenco di bucket e oggetti.
  • Spostamento, copia e ridenominazione degli oggetti.
  • Modifica degli ACL di oggetti e bucket.

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

Devi utilizzare gsutil?

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

  • Lo strumento gsutil è una CLI Cloud Storage legacy e viene gestito in modo minimale.

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

  • I comandi gcloud storage richiedono meno ottimizzazione manuale per ottenere le velocità di caricamento e download più elevate.

Eseguire la migrazione a gcloud CLI

Se sei un utente gsutil che vuole 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, 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, significa che hai già installato gcloud CLI.

Una volta installata gcloud CLI, puoi utilizzare i comandi gcloud storage proprio come utilizzi 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 risorse esatte, gsutil supporta l'utilizzo di caratteri jolly nei comandi.

Guida integrata

gsutil contiene una guida integrata completa su ogni comando, nonché 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. Ad esempio, gsutil help cp e gsutil help options sono rispettivamente una pagina di assistenza per i comandi e una pagina di assistenza per gli argomenti.

Per ottenere 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 contribuiscono a migliorare lo strumento gsutil. Se in un secondo momento 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 offrirti volontario per contribuire allo sviluppo di gsutil, visita il progetto gsutil su GitHub.

Limitazioni

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

Passaggi successivi