Kurzanleitung: gsutil-Tool verwenden

Auf dieser Seite wird gezeigt, wie Sie grundlegende Aufgaben in Cloud Storage mit dem gsutil-Befehlszeilentool ausführen.

In Cloud Storage entstehende Kosten basieren auf den verwendeten Ressourcen. Die in diesem Schnellstart genutzten Cloud Storage-Ressourcen betragen in der Regel weniger als 0,01 US-Dollar.

Hinweis

1. Melden Sie sich bei Ihrem Google-Konto an.

   Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

2. Klicken Sie in der Google Cloud Console auf der Seite der Projektauswahl auf Erstellen, um ein neues Google Cloud-Projekt zu erstellen.

   Zur Projektauswahl

3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

4. Installieren Sie das Cloud SDK.

   Wenn Sie dazu aufgefordert werden, wählen Sie das zuvor erstellte Projekt aus.

5. Installieren Sie Python 3.8.

   Wenn Sie Windows verwenden und bei der Installation des Cloud SDK das entsprechende Kästchen ausgewählt haben, wurde die Installation automatisch durchgeführt.

Hinweis: Wenn Sie Cloud Shell oder eine Compute Engine-Instanz verwenden, sind Python und gsutil vorinstalliert und authentifiziert. Sollte Ihre Compute Engine-Instanz ohne Dienstkontobereich für Cloud Storage eingerichtet sein, führen Sie gsutil config aus und folgen dann der Anleitung.

Hinweis: Wenn Sie Windows verwenden und gsutil nicht als Teil des Cloud SDK installiert haben, müssen Sie jedem gsutil-Befehl python voranstellen (z. B. python gsutil mb gs://my-awesome-bucket). Weitere Informationen finden Sie in den FAQ zu Python unter Windows.

Bucket erstellen

Buckets sind die grundlegenden Container, die Ihre Daten enthalten.

So erstellen Sie einen Bucket:

1. Öffnen Sie ein Terminalfenster.

2. Verwenden Sie den Befehl gsutil mb und einen nur einmal vorkommenden Namen, um einen Bucket zu erstellen:

   gsutil mb -b on -l us-east1 gs://my-awesome-bucket/

   Dadurch wird ein Bucket mit dem Namen "my-awesome-bucket" erstellt. Wählen Sie Ihren eigenen global eindeutigen Bucket-Namen aus.

   Siehe "Anforderungen für Bucket-Namen".

   • Bucket-Namen dürfen nur Kleinbuchstaben, Ziffern, Bindestriche (-), Unterstriche (_) und Punkte (.) enthalten. Leerzeichen sind nicht zulässig. Für Namen mit Punkten ist eine Bestätigung erforderlich.
   • Bucket-Namen müssen mit einer Ziffer oder einem Buchstaben beginnen und enden.
   • Bucket-Namen dürfen 3 bis 63 Zeichen lang sein. Namen mit Punkten dürfen bis zu 222 Zeichen lang sein, wobei jeder durch einen Punkt getrennte Teil nicht mehr als 63 Zeichen enthalten darf.
   • Bucket-Namen dürfen nicht wie eine IP-Adresse im Dezimalformat mit Punkten als Trennzeichen dargestellt werden (z. B. 192.168.5.4).
   • Bucket-Namen dürfen nicht mit dem Präfix "goog" beginnen.
   • Bucket-Namen dürfen weder das Wort "google" noch ähnliche, falsch geschriebene Versionen des Wortes (z. B. "g00gle") enthalten.
   Achtung: Der Bucket-Name darf keine vertraulichen Informationen enthalten, da der Bucket-Namespace global und öffentlich sichtbar ist.

   Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

   Creating gs://my-awesome-bucket/...

Sie haben gerade einen Bucket erstellt, in dem Sie Ihre Daten speichern können.

Hinweis: Wenn der ausgewählte Bucket-Name bereits von Ihnen oder einer anderen Person verwendet wird, gibt der Befehl Folgendes zurück:

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Versuchen Sie es noch einmal mit einem anderen Bucket-Namen.

Objekt in den Bucket laden

1. Klicken Sie mit der rechten Maustaste auf das Bild oben und speichern Sie es auf Ihrem Computer, z. B. auf dem Desktop.

   Hinweis: Wenn Sie Cloud Shell oder eine Compute Engine-Instanz verwenden, laden Sie das Bild mithilfe von wget https://cloud.google.com/storage/images/kitten.png herunter.

2. Kopieren Sie das Bild mit dem Befehl gsutil cp aus seinem Speicherort in den von Ihnen erstellten Bucket:

   gsutil cp Desktop/kitten.png gs://my-awesome-bucket

   Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

   Copying file://Desktop/kitten.png [Content-Type=image/png]...
   Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
   Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

   Damit haben Sie ein Objekt in Ihrem Bucket gespeichert.

Hinweis: Sie können den Bucket-Namen während der Eingabe mithilfe der Tabulatortaste automatisch vervollständigen.

Objekt aus dem Bucket herunterladen

1. Verwenden Sie den Befehl gsutil cp, um das in Ihrem Bucket gespeicherte Bild an einen beliebigen Ort auf Ihrem Computer herunterzuladen, z. B. auf den Desktop:

   gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

   Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

   Copying gs://my-awesome-bucket/kitten.png...
   Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
   Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

   Sie haben gerade etwas aus dem Bucket heruntergeladen.

Objekt in einen Ordner im Bucket kopieren

1. Verwenden Sie den Befehl gsutil cp, um einen Ordner zu erstellen und das Bild in diesen zu kopieren:

   gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

   Hinweis: Für Ordner in Cloud Storage gelten Einschränkungen im Vergleich zu lokalen Dateisystemen, aber es werden viele der gleichen Vorgänge unterstützt.

   Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

   Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
   Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

   Sie haben soeben Ihr Bild in einen neuen Ordner in Ihrem Bucket kopiert.

Inhalt eines Buckets oder Ordners auflisten

1. Verwenden Sie den Befehl gsutil ls, um den Inhalt auf oberster Ebene des Buckets aufzulisten:

   gsutil ls gs://my-awesome-bucket

   Wenn der Vorgang erfolgreich ist, wird eine Meldung wie die folgende zurückgegeben:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/just-a-folder/

   Sie haben gerade den Inhalt auf der obersten Ebene des Buckets angesehen.

Details zu einem Objekt auflisten

1. Verwenden Sie den Befehl gsutil ls mit dem Flag -l, um Details zu einem Ihrer Bilder abzurufen:

   gsutil ls -l gs://my-awesome-bucket/kitten.png

   Wenn der Vorgang erfolgreich durchgeführt wurde, wird eine Meldung folgender Art angezeigt:

   2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
   TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

   Sie haben gerade Informationen zur Größe und zum Erstellungsdatum des Bildes abgerufen.

Objekte öffentlich zugänglich machen

1. Verwenden Sie den Befehl gsutil iam ch, um allen Nutzern die Berechtigung zu erteilen, die in Ihrem Bucket gespeicherten Bilder auszulesen:

   gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket

   Der Befehl ist erfolgreich, wenn kein Fehler zurückgegeben wird.

   Jetzt kann jeder Ihre Bilder abrufen.

2. Wenn Sie diesen Zugriff entfernen, möchten verwenden Sie den folgenden Befehl:

   gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket

   Der Befehl ist erfolgreich, wenn kein Fehler zurückgegeben wird.

   Sie haben den öffentlichen Zugriff auf die Bilder in Ihrem Bucket entfernt.

Hinweis: Nachdem Sie den öffentlichen Zugriff entfernt haben, können Sie möglicherweise noch eine Zeit lang auf eine im Cache gespeicherte Version von einem Ihrer Bilder zugreifen.

Zugriff auf Ihren Bucket gewähren

1. Verwenden Sie den Befehl gsutil iam ch, um einer bestimmten E-Mail-Adresse Lese- und Schreibzugriff auf Objekte in Ihrem Bucket zu gewähren:

   gsutil iam ch user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   Der Befehl ist erfolgreich, wenn kein Fehler zurückgegeben wird.

   Nun kann jemand anderes etwas in den Bucket hochladen und Inhalte einsehen.

2. Mit dem folgenden Befehl heben Sie diese Berechtigung wieder auf:

   gsutil iam ch -d user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   Der Befehl ist erfolgreich, wenn kein Fehler zurückgegeben wird.

   Damit haben Sie den Zugriff des Nutzers auf diesen Bucket entfernt.

Objekt löschen

1. Verwenden Sie den Befehl gsutil rm, um eines Ihrer Bilder zu löschen:

   gsutil rm gs://my-awesome-bucket/kitten.png

   Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

   Removing gs://my-awesome-bucket/kitten.png...

   Diese Kopie des Bildes wird nicht mehr in Cloud Storage gespeichert. Die Kopie im Ordner just-a-folder/ ist jedoch noch vorhanden.

Bereinigen

So vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Kurzanleitung verwendeten Ressourcen in Rechnung gestellt werden:

1. Öffnen Sie ein Terminalfenster, wenn nicht bereits geschehen.

2. Verwenden Sie den gsutil-Befehl rm command mit dem Flag -r, um den Bucket und seinen Inhalt zu löschen.

   gsutil rm -r gs://my-awesome-bucket

   Wenn der Vorgang erfolgreich ist, wird eine Meldung wie die folgende zurückgegeben:

   Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
   Removing gs://my-awesome-bucket/...

   Der Bucket und sein Inhalt wurden gelöscht.

Nächste Schritte

• Cloud Storage-Kurzanleitung mit der Google Cloud Console durcharbeiten
• Lesen Sie die verfügbaren Handbücher, um Aufgaben in Cloud Storage abzuschließen.
• Die wichtigsten Begriffe in Cloud Storage
• Cloud Storage – Preise
• Referenzseiten für gsutil-Befehle wie make bucket (mb), copy (cp), list (ls), identity access management (iam) und remove (rm) ansehen