Objektspeicher mit der Google Cloud CLI entdecken

Objektspeicher mit der Google Cloud CLI entdecken

Auf dieser Seite erfahren Sie, wie Sie mit der Google Cloud CLI grundlegende Aufgaben in Cloud Storage ausführen.

In Cloud Storage entstehende Kosten basieren auf den verwendeten Ressourcen. Die in dieser Kurzanleitung genutzten Cloud Storage-Ressourcen verursachen in der Regel weniger als 0,01 US-Dollar an Kosten.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Installieren Sie die Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.
Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind
• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen
Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.
• So erstellen Sie ein Google Cloud -Projekt:

  gcloud projects create PROJECT_ID

  Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud -Projekt, das Sie erstellen.

• Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .
Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.
Weisen Sie Ihrem Nutzerkonto Rollen zu. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Ersetzen Sie Folgendes:
• PROJECT_ID: Ihre Projekt-ID.
• USER_IDENTIFIER: Die Kennung für Ihr Nutzerkonto . Beispiel: [e-mail]
• ROLE: Die IAM-Rolle, die Sie Ihrem Nutzerkonto zuweisen.

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

• So erstellen Sie ein Google Cloud -Projekt:

  gcloud projects create PROJECT_ID

  Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud -Projekt, das Sie erstellen.

• Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

Weisen Sie Ihrem Nutzerkonto Rollen zu. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/storage.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Ersetzen Sie Folgendes:

• PROJECT_ID: Ihre Projekt-ID.
• USER_IDENTIFIER: Die Kennung für Ihr Nutzerkonto . Beispiel: [e-mail]
• ROLE: Die IAM-Rolle, die Sie Ihrem Nutzerkonto zuweisen.

Hinweis :Wenn Sie Cloud Shell oder eine Compute Engine-Instanz verwenden, ist das Google Cloud SDK vorinstalliert und authentifiziert. Sollte Ihre Compute Engine-Instanz ohne Dienstkontobereich für Cloud Storage eingerichtet sein, führen Sie gcloud init aus und beachten Sie die Anleitung.

Bucket erstellen

Buckets sind die grundlegenden Container, die Ihre Daten in Cloud Storage enthalten.

So erstellen Sie einen Bucket:

1. Öffnen Sie ein Terminalfenster.

2. Verwenden Sie den Befehl gcloud storage buckets create und einen global eindeutigen Namen, um einen Bucket zu erstellen:

   gcloud storage buckets create gs://BUCKET_NAME/ --uniform-bucket-level-access

   Ersetzen Sie BUCKET_NAME durch einen Namen für den Bucket.

   Achtung :Der Bucket-Name darf keine vertraulichen Informationen enthalten, da der Bucket-Namespace global und öffentlich sichtbar ist.
   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.

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

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

   Wenn der ausgewählte Bucket-Name bereits von Ihnen oder einer anderen Person verwendet wird, gibt der Befehl eine Antwort wie ServiceException: 409 Bucket my-awesome-bucket already exists. Try again with a different bucket name (Versuchen Sie es noch einmal mit einem anderen Bucket-Namen) zurück.

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

Objekt in den Bucket laden

1. Speichern Sie das folgende Bild auf Ihrem Computer, z. B. auf dem Desktop.

   

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

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

   gcloud storage cp Desktop/kitten.png gs://BUCKET_NAME

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

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   Copying file://Desktop/kitten.png to gs://my-awesome-bucket/kitten.png
     Completed files 1/1 | 8.6kiB/8.6kiB

   Damit haben Sie ein Objekt in Ihrem Bucket gespeichert.

Objekt aus dem Bucket herunterladen

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

   gcloud storage cp gs://BUCKET_NAME/kitten.png Desktop/kitten2.png

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   Copying gs://my-awesome-bucket/kitten.png to file://Desktop/kitten2.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

   Sie haben gerade etwas aus dem Bucket heruntergeladen.

Objekt in einen simulierten Ordner im Bucket kopieren

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

   gcloud storage cp gs://BUCKET_NAME/kitten.png gs://BUCKET_NAME/quickstart-folder/kitten3.png

   Hinweis :Für simulierte Ordner in Cloud Storage gelten Einschränkungen im Vergleich zu lokalen Dateisystemen oder Ordnern in Buckets mit aktiviertem hierarchischem Namespace, aber es werden viele der gleichen Vorgänge unterstützt.

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   Copying gs://my-awesome-bucket/kitten.png to gs://my-awesome-bucket/quickstart-folder/kitten3.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

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

Inhalt eines Buckets auflisten

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

   gcloud storage ls gs://BUCKET_NAME

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/quickstart-folder/

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

Details zu einem Objekt auflisten

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

   gcloud storage ls gs://BUCKET_NAME/kitten.png --long

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   8775  2026-01-21T01:22:17Z  gs://srs-bucketcli/kitten.png
   TOTAL: 1 objects, 8775 bytes (8.57kiB)

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

Objekte öffentlich zugänglich machen

1. Verwenden Sie den Befehl gcloud storage buckets add-iam-policy-binding, um allen Nutzern die Berechtigung zu erteilen, die in Ihrem Bucket gespeicherten Bilder auszulesen:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

   Der Befehl war erfolgreich, wenn die Antwort Folgendes enthält:

   bindings:
     - members:
       - allUsers
       role: roles/storage.objectViewer
   

   Jetzt kann jeder Ihre Bilder abrufen.

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

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

   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 Ihrer Bilder zugreifen.

Zugriff auf Ihren Bucket gewähren

1. Verwenden Sie den Befehl gcloud storage buckets add-iam-policy-binding, um einer bestimmten E-Mail-Adresse die Berechtigung zum Hinzufügen von Objekten zum Bucket zu erteilen:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=user:[e-mail] --role=roles/storage.objectCreator

   Der Befehl war erfolgreich, wenn die Antwort Folgendes enthält:

   bindings:
     - members:
       - user:[e-mail]
       role: roles/storage.objectCreator
   

   Dieser Nutzer kann Ihrem Bucket jetzt Elemente hinzufügen.

2. Mit dem folgenden Befehl heben Sie die öffentliche Zugriffsberechtigung wieder auf:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=user:[e-mail] --role=roles/storage.objectCreator

   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 gcloud storage rm, um eines Ihrer Bilder zu löschen:

   gcloud storage rm gs://BUCKET_NAME/kitten.png

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

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

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

Bereinigen

Löschen Sie das Projekt von Google Cloud zusammen mit den Ressourcen, damit Ihrem Konto von Google Cloud die auf dieser Seite verwendeten Ressourcen nicht in Rechnung gestellt werden.

1. Verwenden Sie den gcloud storage rm-Befehl mit dem Flag --recursive, um den Bucket und seinen Inhalt zu löschen:

   gcloud storage rm gs://BUCKET_NAME --recursive

   Wenn der Vorgang erfolgreich durchgeführt wurde, gibt der Befehl eine Antwort wie die folgende zurück:

   Removing objects:
   Removing gs://my-awesome-bucket/quickstart-folder/kitten3.png#1768960201129254
     Completed 1/1
   Removing buckets:
   Removing gs://my-awesome-bucket/...
     Completed 1/1

   Der Bucket und sein Inhalt wurden gelöscht.

Nächste Schritte

• Cloud Storage-Kurzanleitung mit der Google Cloud -Konsole durcharbeiten
• Cloud Storage-Produktübersicht.
• Informationen zu Cloud Storage-Preisen.
• Weitere Informationen finden Sie auf den Referenzseiten für gcloud CLI-Befehle. Beispiel:
  • Buckets erstellen (buckets create)
  • Objekte hochladen, herunterladen und kopieren (cp)
  • Buckets und Objekte auflisten (ls)
  • Zugriff auf Buckets hinzufügen (buckets add-iam-policy-binding)
  • Objekte und Buckets löschen (rm)