Einige oder alle Informationen auf dieser Seite gelten möglicherweise nicht für Cloud de Confiance von S3NS. Weitere Informationen finden Sie unter Unterschiede zu Google Cloud.

Diese Seite wurde von der Cloud Translation API übersetzt.

Objektspeicher mit dem gcloud-Tool erforschen

Auf dieser Seite wird gezeigt, wie Sie grundlegende Aufgaben in Cloud Storage mit dem gcloud-Befehlszeilentool 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.

Hinweise

Install the Google Cloud CLI.
Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
```
gcloud init
```
Create or select a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
- Create a Cloud de Confiance project:
```
gcloud projects create PROJECT_ID
```
  Replace PROJECT_ID with a name for the Cloud de Confiance project you are creating.
- Select the Cloud de Confiance project that you created:
```
gcloud config set project PROJECT_ID
```
  Replace PROJECT_ID with your Cloud de Confiance project name.
Verify that billing is enabled for your Cloud de Confiance project.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
```
Replace the following:
- PROJECT_ID: Your project ID.
- USER_IDENTIFIER: The identifier for your user account. For examples, see Represent workforce pool users in IAM policies.
- ROLE: The IAM role that you grant to your user account.

Bucket erstellen

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

So erstellen Sie einen Bucket:

Öffnen Sie ein Terminalfenster.
Verwenden Sie den Befehl gcloud storage buckets create und einen nur einmal vorkommenden Namen, um einen Bucket zu erstellen:
```
gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access --location=LOCATION_NAME
```
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 (-) und Unterstriche (_) enthalten. Leerzeichen sind nicht zulässig.
- 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.

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

Das Bild eines Kätzchens

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 eine Compute Engine-Instanz verwenden, laden Sie das Bild mit dem folgenden Befehl herunter: wget https://cloud.google.com/storage/images/kitten.png

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://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.

Objekt aus dem Bucket herunterladen

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://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

Verwenden Sie den Befehl gcloud storage cp, um einen Ordner zu erstellen und das Bild in diesen zu kopieren:
```
gcloud storage 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

Verwenden Sie den Befehl gcloud storage ls, um den Inhalt auf oberster Ebene des Buckets aufzulisten:
```
gcloud storage ls gs://my-awesome-bucket
```
Wenn der Vorgang erfolgreich durchgeführt wurde, wird eine Meldung folgender Art angezeigt:
```
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

Verwenden Sie den Befehl gcloud storage ls mit dem Flag --long, um Details zu einem Ihrer Bilder abzurufen:
```
gcloud storage ls gs://my-awesome-bucket/kitten.png --long
```
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

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://my-awesome-bucket --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.
Wenn Sie diesen Zugriff entfernen, möchten verwenden Sie den folgenden Befehl:
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --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.

Zugriff auf Ihren Bucket gewähren

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://my-awesome-bucket --member=user:example-service-account@example-project.s3ns.iam.gserviceaccount.com --role=roles/storage.objectCreator

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

bindings:
  - members:
    - user:example-service-account@example-project.s3ns.iam.gserviceaccount.com
    role: roles/storage.objectCreator

Nun kann jemand anderes Ihrem Bucket Elemente hinzufügen.

Mit dem folgenden Befehl heben Sie diese Berechtigung wieder auf:
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns.iam.gserviceaccount.com --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

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

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

Öffnen Sie ein Terminalfenster, wenn nicht bereits geschehen.
Verwenden Sie den gcloud storage rm-Befehl mit dem Flag --recursive, um den Bucket und seinen Inhalt zu löschen:
```
gcloud storage rm gs://my-awesome-bucket --recursive
```
Wenn der Vorgang erfolgreich durchgeführt wurde, wird eine Meldung folgender Art angezeigt:
```
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

Weitere Informationen finden Sie auf den Referenzseiten für Google Cloud CLI-Befehle, z. B. Bucket erstellen (buckets create), Kopieren (cp), Liste (ls), Zugriff hinzufügen (buckets add-iam-policy-binding) und Entfernen (rm).