Buckets mit vorläufig gelöschten Elementen verwenden

Vorläufiges Löschen – Übersicht

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 aufbewahrt. In diesem Status kann er nicht mehr 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 im Bucket. 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 in den Status „Live“ zurückversetzt. Objekte, die sich zum Zeitpunkt des Löschens im Bucket befanden, können ebenfalls wiederhergestellt werden.

Hinweise

  • Zum Schutz vor böswilligem Löschen kann ein vorläufig gelöschter Bucket erst endgültig gelöscht werden, wenn er die vollständige Aufbewahrungsdauer für vorläufiges Löschen erreicht hat.

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

  • Wenn Sie einen vorläufig gelöschten Bucket wiederherstellen möchten, benötigen Sie die Generation-Nummer 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 es keinen aktiven Bucket mit demselben Namen gibt. 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 der Wiederherstellung von Buckets werden keine vorläufig gelöschten Objekte wiederhergestellt, die sich zum Zeitpunkt des Löschens im Bucket befanden. Wenn Sie vorläufig gelöschte Objekte wiederherstellen möchten, nachdem der Bucket mit den vorläufig gelöschten Objekten wiederhergestellt wurde, müssen Sie einen Objektwiederherstellungsvorgang ausführen.

  • Tag-Bindungen können möglicherweise nicht wiederhergestellt werden, wenn Sie einen vorläufig gelöschten Bucket mit Tags wiederherstellen. Um Datenverluste zu vermeiden, sollten Sie beim Wiederherstellen eines vorläufig gelöschten Buckets mit Tag-Bindungen 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

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Wiederherstellen vorläufig gelöschter Bucket 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 weich gelöschten Bucket zu abrufen.

So listen Sie alle vorläufig gelöschten Bucket 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 weich 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 Buckets, der mit der Soft Delete-Funktion gelöscht wurde und wiederhergestellt werden soll.

  • GENERATION_NUMBER: die permanente, eindeutige Generierungsnummer des vorläufig gelöschten Buckets, den Sie wiederherstellen möchten. Informationen zum Abrufen der Generation der Bucket-ID 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 dauerhafte, eindeutige Generierungsnummer des vorläufig gelöschten Buckets, den Sie wiederherstellen möchten. Informationen zum Abrufen der Generation der Bucket-ID finden Sie unter Vorläufig gelöschte Buckets auflisten.

Cloud Storage stellt den per Soft-Delete gelöschten Bucket in einen Live-Zustand wieder her. Hinweis: Durch das Wiederherstellen des Buckets werden nicht die Objekte wiederhergestellt, 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