Buckets verschieben und umbenennen

Wenn Sie einen Bucket erstellen, sind einige der Attribute, die Sie festlegen, dauerhaft und können nicht geändert werden, einschließlich des Namens des Buckets, seines geografischen Standorts und des Projekts, zu dem er gehört. Sie können Buckets jedoch effektiv verschieben oder umbenennen:

Wenn sich in Ihrem alten Bucket keine Daten befinden, löschen Sie den Bucket und erstellen einen weiteren Bucket mit den gewünschten Attributen.
Enthält der alte Bucket Daten, erstellen Sie einen neuen Bucket mit den gewünschten Attributen, kopieren die Daten aus dem alten Bucket in den neuen und löschen den alten Bucket und dessen Inhalt. Die Schritte auf dieser Seite beschreiben diesen Vorgang.
- Wenn der neue Bucket den Namen Ihres alten Buckets übernehmen soll, müssen Sie die Daten vorübergehend in einen Bucket mit einem anderen Namen verschieben. Sie können dann den ursprünglichen Bucket löschen, sodass Sie den Bucket-Namen wiederverwenden können.
- Das Verschieben von Daten zwischen Standorten verursacht Kosten für die Netzwerknutzung. Außerdem können durch das Verschieben von Daten zusätzliche Kosten anfallen, je nach Speicherklassen der Quelldaten und Standort des Ziel-Buckets. Weitere Informationen finden Sie unter Cloud Storage – Preise.

Erforderliche Berechtigungen

Console

Sie benötigen die entsprechenden IAM-Berechtigungen, um diesen Leitfaden mit der Google Cloud Console abzuschließen. Wenn die sich Buckets, auf die Sie zugreifen möchten, in einem Projekt befinden, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.

Eine Liste der erforderlichen Berechtigungen für bestimmte Aktionen finden Sie unter IAM-Berechtigungen für die Google Cloud Console.

Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.

Befehlszeile

Damit Sie diese Anleitung mit einem Befehlszeilen-Dienstprogramm ausführen können, benötigen Sie die entsprechenden IAM-Berechtigungen. Wenn die sich Buckets, auf die Sie zugreifen möchten, in einem Projekt befinden, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.

Eine Liste der erforderlichen Berechtigungen für bestimmte Aktionen finden Sie unter IAM-Berechtigungen für gcloud storage-Befehle.

Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.

REST APIs

JSON API

Sie benötigen die entsprechenden IAM-Berechtigungen, um diese Anleitung mit der JSON API abzuschließen. Wenn die sich Buckets, auf die Sie zugreifen möchten, in einem Projekt befinden, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.

Eine Liste der für bestimmte Aktionen erforderlichen Berechtigungen finden Sie unter IAM-Berechtigungen für JSON-Methoden.

Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.

Daten zwischen Buckets verschieben

Console

Verwenden Sie den Cloud Storage Transfer Service in der Google Cloud Console:

Wenn Sie noch keinen Ziel-Bucket haben, erstellen Sie den Bucket.
Öffnen Sie in der Google Cloud Console die Seite „Übertragen“.

Öffnen Sie die Seite Übertragung.
Klicken Sie auf Übertragung erstellen.
Führen Sie die folgenden Schritte aus und klicken Sie dabei nach jedem Schritt auf Nächster Schritt:
- Quelle auswählen: Verwenden Sie Google Cloud Storage-Bucket als Quelltyp und geben Sie entweder direkt den Namen des gewünschten Buckets ein oder klicken Sie auf Durchsuchen, um die Suche zu starten und wählen Sie den gewünschten Bucket aus.
- Ziel auswählen: Geben Sie entweder den Namen des gewünschten Buckets direkt ein oder klicken Sie auf Durchsuchen, um den gewünschten Bucket zu suchen und auszuwählen.
- Einstellungen auswählen: Wählen Sie die Option Dateien nach der Übertragung aus der Quelle löschen aus.
- Planungsoptionen: Diesen Abschnitt können Sie ignorieren.
Nachdem Sie alle Schritte ausgeführt haben, klicken Sie auf Erstellen.

Damit beginnt das Kopieren der Objekte aus dem alten Bucket in den neuen. Der Vorgang kann einige Zeit in Anspruch nehmen. Nachdem Sie auf Erstellen geklickt haben, können Sie die Google Cloud Console aber verlassen.

So sehen Sie den Fortschritt der Übertragung:
Öffnen Sie in der Google Cloud Console die Seite „Übertragen“.

Zur Seite Datenübertragung

Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Sie müssen nichts unternehmen, um die Objekte aus dem alten Bucket zu löschen, sobald die Übertragung abgeschlossen ist. Dazu müssen Sie bei der Einrichtung das Kästchen Quellobjekte nach Übertragung löschen ausgewählt haben. Sie können jedoch auch Ihren alten Bucket löschen, was Sie separat machen müssen.

Befehlszeile

Erstellen Sie einen Ziel-Bucket, falls Sie noch keinen haben.
Verwenden Sie eine der folgenden Methoden, um den Inhalt Ihres Quell-Buckets in den Ziel-Bucket zu kopieren:
- Verwenden Sie den Befehl gcloud storage cp mit der Option --recursive, um alle Objekte rekursiv aus dem Quell-Bucket in den Ziel-Bucket zu kopieren:
```
gcloud storage cp --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET
```
  Wobei:
  - SOURCE_BUCKET ist der Name des ursprünglichen Buckets. Beispiel: old-bucket.
  - DESTINATION_BUCKET ist der Name des Buckets, in den Sie Ihre Daten verschieben. Beispiel: my-bucket.
- Zum rekursiven Kopieren aller Objekte und verwalteten Ordner aus dem Quell-Bucket in den Ziel-Bucket verwenden Sie den Befehl gcloud alpha storage cp mit den Optionen --include-managed-folders und --recursive:
```
gcloud alpha storage cp --include-managed-folders --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET
```
  Wobei:
  - SOURCE_BUCKET ist der Name des ursprünglichen Buckets. Beispiel: old-bucket.
  - DESTINATION_BUCKET ist der Name des Buckets, in den Sie Ihre Daten verschieben. Beispiel: my-bucket.
Verwenden Sie eine der folgenden Methoden, um den Quell-Bucket zu löschen:
- Wenn Sie alle Objekte aus dem Quell-Bucket zusammen mit dem Quell-Bucket selbst rekursiv löschen möchten, verwenden Sie den Befehl gcloud storage rm mit der Option --recursive:
```
gcloud storage rm --recursive gs://SOURCE_BUCKET
```
  Dabei ist SOURCE_BUCKET der Name des ursprünglichen Buckets. Beispiel: old-bucket.
- Wenn Sie alle Objekte und verwalteten Ordner aus dem Quell-Bucket zusammen mit dem Quell-Bucket selbst rekursiv löschen möchten, verwenden Sie den Befehl gcloud alpha storage rm mit der Option --recursive:
```
gcloud alpha storage rm --recursive gs://SOURCE_BUCKET
```
  Dabei ist SOURCE_BUCKET der Name des ursprünglichen Buckets. Beispiel: old-bucket.
- Wenn Sie die Objekte und verwalteten Ordner aus dem Quell-Bucket löschen möchten, ohne den Quell-Bucket selbst zu löschen, verwenden Sie den gcloud alpha storage rm-Befehl ohne das Flag --recursive:
```
gcloud alpha storage rm --all-versions gs://SOURCE_BUCKET/**
```
  Dabei ist SOURCE_BUCKET der Name des ursprünglichen Buckets. Beispiel: old-bucket.

REST APIs

JSON API

Wenn Sie noch keinen Ziel-Bucket haben, erstellen Sie den Bucket.
Kopieren Sie alle Objekte aus Ihrem Quell-Bucket in den Ziel-Bucket.
Löschen Sie alle Objekte in Ihrem Quell-Bucket.
Löschen Sie Ihren Quell-Bucket.

XML API

Wenn Sie noch keinen Ziel-Bucket haben, erstellen Sie den Bucket.
Kopieren Sie alle Objekte aus Ihrem Quell-Bucket in den Ziel-Bucket.
Löschen Sie alle Objekte in Ihrem Quell-Bucket.
Löschen Sie Ihren Quell-Bucket.

Nächste Schritte

Einzelne Objekte kopieren, umbenennen oder verschieben.
Informationen zu verfügbaren Bucket-Standorten und Benennungsrichtlinien für Buckets
Weitere Informationen zum Erstellen und Verwalten von Datenübertragungen mit der Google Cloud Console.
Sehen Sie sich das Tool zum Verschieben von Buckets an, ein inoffizielles Tool zum einfacheren Verschieben von Buckets.