gsutil-Tool

gsutil ist eine Python-Anwendung, mit der Sie über die Befehlszeile auf Cloud Storage zugreifen können. Sie können gsutil für verschiedenste Bucket- und Objektverwaltungsaufgaben verwenden, einschließlich:

  • Buckets erstellen und löschen
  • Objekte hochladen, herunterladen und löschen
  • Buckets und Objekte auflisten
  • Objekte verschieben, kopieren und umbenennen
  • Objekt- und Bucket-ACLs bearbeiten

Gsutil führt alle Vorgänge einschließlich Uploads und Downloads mithilfe von HTTPS und Transport-Layer Security (TLS) aus.

Sollten Sie gsutil verwenden?

Im Allgemeinen sollten Sie gcloud storage-Befehle anstelle von gsutil-Befehlen verwenden:

  • Das gsutil-Tool ist eine Legacy-Cloud Storage-Befehlszeile und wird nur minimal gepflegt.

  • Das gsutil-Tool unterstützt die Arbeit mit neueren Cloud Storage-Features wie Soft Delete und verwaltete Ordner nicht.

  • gcloud storage-Befehle erfordern weniger manuelle Optimierung, um sehr schnelle Upload- und Downloadraten zu erzielen.

Zur gcloud CLI migrieren

Wenn Sie gsutil verwenden und zur gcloud CLI migrieren möchten, sollten Sie zuerst prüfen, ob Sie eine eigenständige Version von gsutil verwenden. Führen Sie dazu den folgenden Befehl aus:

gsutil version -l

  • Wenn das Ergebnis des Befehls using cloud sdk: False enthält, verwenden Sie eine eigenständige Version von gsutil. Wenn Sie zur gcloud CLI migrieren möchten, installieren Sie sie zuerst.

  • Wenn das Ergebnis des Befehls using cloud sdk: True enthält, ist die gcloud CLI bereits installiert.

Nachdem die gcloud CLI installiert ist, können Sie gcloud storage-Befehle genauso verwenden wie gsutil-Befehle. Die folgenden Ressourcen können Ihnen den Einstieg erleichtern:

Syntax für den Zugriff auf Ressourcen

gsutil verwendet das Präfix gs://, um eine Ressource in Cloud Storage anzugeben:

gs://BUCKET_NAME/OBJECT_NAME

Zusätzlich zur Angabe der genauen Ressourcen unterstützt gsutil die Verwendung von Platzhaltern in Befehlen.

Integrierte Hilfe

gsutil enthält eine umfassende integrierte Hilfe für alle Befehle und eine Reihe von Themen, die Sie mit dem Befehl gsutil help auflisten und lesen können.

Wenn Sie Informationen zu einem bestimmten Befehl oder Thema abrufen möchten, geben Sie gsutil help gefolgt vom Befehls- oder Themennamen ein. Beispielsweise sind gsutil help cp und gsutil help options eine Hilfeseite für Befehle bzw. eine Hilfeseite für ein Thema.

Informationen zu Ihrer gsutil-Installation erhalten Sie mit dem Befehl gsutil version:

gsutil version -l

Nutzungsstatistiken

Während der Installation können Sie optional die Nutzungsstatistiken aktivieren, um das gsutil-Tool zu verbessern. Wenn Sie diese Nutzungsstatistiken später bewusst deaktivieren möchten, finden Sie weitere Informationen unter Nutzungsstatistiken.

Über gsutil

gsutil ist ein Open-Source-Projekt. Wenn Sie die Entwicklerversion von gsutil herunterladen oder bei der Entwicklung von gsutil mithelfen möchten, rufen Sie das gsutil-Projekt auf GitHub auf.

Beschränkungen

  • Wenn Sie gsutil mit Windows verwenden, können Befehle, die das globale Flag -m verwenden, nicht mit Ctrl-C abgebrochen werden.

Nächste Schritte