Buckets mit vorläufig gelöschten Elementen verwenden

Funktionsübersicht zum vorläufigen Löschen

Auf dieser Seite wird beschrieben, wie Sie einen vorläufig gelöschten Bucket auflisten und wiederherstellen.

Übersicht

Nachdem ein Bucket vorläufig gelöscht wurde, wird er von Cloud Storage bis zum Zeitpunkt des endgültigen Löschens beibehalten und kann im vorläufig gelöschten Zustand nicht geändert werden. Der Zeitpunkt zum endgültigen Löschen ist mindestens so lang wie der letzte Zeitpunkt zum endgültigen Löschen der Objekte des Buckets. Nach Ablauf der Zeit für das endgültige Löschen löscht Cloud Storage den Bucket endgültig. Wenn Sie einen vorläufig gelöschten Bucket wiederherstellen, wird er wieder in den Status „Live“ versetzt. Objekte, die sich zum Zeitpunkt des Löschens im Bucket befanden, können ebenfalls wiederhergestellt werden.

Hinweise

  • Um vor böswilligem Löschen zu schützen, kann ein vorläufig gelöschter Bucket erst endgültig gelöscht werden, wenn er die gesamte Aufbewahrungsdauer für vorläufiges Löschen durchlaufen hat.

  • Wenn ein Bucket vorläufig gelöscht wurde, müssen Sie ihn wiederherstellen, bevor Sie die vorläufig gelöschten Objekte darin auflisten oder wiederherstellen können.

  • Um einen vorläufig gelöschten Bucket wiederherzustellen, benötigen Sie die Generierungsnummer des Buckets. Informationen zum Abrufen der Generierungsnummer eines vorläufig gelöschten Buckets finden Sie unter Vorläufig gelöschte Buckets auflisten.

  • Ein vorläufig gelöschter Bucket kann nur wiederhergestellt werden, wenn kein aktiver Bucket mit demselben Namen vorhanden ist. Wenn Sie oder jemand anderes einen Bucket mit demselben Namen wie ein vorläufig gelöschter Bucket erstellt, können Sie den vorläufig gelöschten Bucket erst wiederherstellen, wenn der neue Bucket gelöscht wurde.

  • Bei Bucket-Wiederherstellungsvorgängen werden die vorläufig gelöschten Objekte, die sich zum Zeitpunkt des Löschens im Bucket befanden, nicht wiederhergestellt. Wenn Sie vorläufig gelöschte Objekte wiederherstellen möchten, nachdem der vorläufig gelöschte Bucket wiederhergestellt wurde, müssen Sie einen Vorgang zum Wiederherstellen von Objekten ausführen.

  • Tag-Bindungen werden möglicherweise nicht wiederhergestellt, wenn Sie einen vorläufig gelöschten Bucket mit Tags wiederherstellen. Um Datenverlust zu vermeiden, empfehlen wir, nach dem Wiederherstellen eines vorläufig gelöschten Buckets mit Tag-Bindungen zu prüfen, ob die Tag-Bindungen des Buckets wiederhergestellt wurden. Wenn die Tag-Bindungen des Buckets nicht wiederhergestellt wurden, müssen Sie die nicht wiederhergestellten Tags manuell an den Bucket binden.

Erforderliche Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Storage-Administrator (roles/storage.admin) für das Cloud Storage-Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Wiederherstellen vorläufig gelöschter Buckets benötigen.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Wiederherstellen vorläufig gelöschter Buckets erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Wiederherstellen von vorläufig gelöschten Buckets erforderlich:

  • storage.buckets.list
  • storage.buckets.restore

Vorläufig gelöschte Buckets auflisten

Sie können Listenvorgänge ausführen, um die Metadaten Ihrer vorläufig gelöschten Buckets abzurufen.

So listen Sie alle vorläufig gelöschten Buckets in Ihrem Projekt auf:

Befehlszeile

Verwenden Sie den Befehl gcloud storage ls, um alle vorläufig gelöschten Buckets aufzulisten:

gcloud storage ls --buckets --soft-deleted --full

REST APIs

JSON API

  1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer GET-Bucket-Anfrage aufzurufen:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b?softDeleted=true"

Vorläufig gelöschten Bucket wiederherstellen

So stellen Sie einen vorläufig gelöschten Bucket wieder her:

Befehlszeile

Verwenden Sie den Befehl gcloud storage restore, um einen vorläufig gelöschten Bucket wiederherzustellen:

  gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Ersetzen Sie Folgendes:

  • BUCKET_NAME: der Name des vorläufig gelöschten Buckets, den Sie wiederherstellen möchten.

  • GENERATION_NUMBER: die permanente, eindeutige Generierungsnummer des vorläufig gelöschten Buckets, den Sie wiederherstellen möchten. Informationen zum Abrufen der Generationsnummer Ihres Buckets finden Sie unter Vorläufig gelöschte Buckets auflisten.

REST APIs

JSON API

  1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer POST-Bucket-Anfrage aufzurufen:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/restore?generation=GENERATION_NUMBER

    Wobei:

    • BUCKET_NAME ist der Name des Buckets, den Sie wiederherstellen möchten. Beispiel: my-bucket.

    • GENERATION_NUMBER ist die permanente, eindeutige Generierungsnummer des vorläufig gelöschten Buckets, den Sie wiederherstellen möchten. Informationen zum Abrufen der Generationsnummer Ihres Buckets finden Sie unter Vorläufig gelöschte Buckets auflisten.

Cloud Storage stellt den vorläufig gelöschten Bucket in einem Live-Zustand wieder her. Beachten Sie, dass beim Wiederherstellen des Buckets nicht die Objekte wiederhergestellt werden, die sich zum Zeitpunkt des vorläufigen Löschens im Bucket befanden. Informationen zum Wiederherstellen der vorläufig gelöschten Objekte, die sich zum Zeitpunkt des Löschens im Bucket befanden, finden Sie unter Vorläufig gelöschtes Objekt wiederherstellen.

Nächste Schritte