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 für die Dauer der Aufbewahrungsdauer für das vorläufige Löschen aufbewahrt. In diesem Status kann er nicht geändert werden. Nach Ablauf der Aufbewahrungsdauer für das vorläufige Löschen löscht Cloud Storage den Bucket und seine Objekte endgültig. Buckets, für die zum Zeitpunkt des Löschens die Funktion Vorläufiges Löschen aktiviert war, können innerhalb der Aufbewahrungsdauer für das vorläufige Löschen wiederhergestellt werden. 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

  • Wenn Sie einen vorläufig gelöschten Bucket wiederherstellen möchten, 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.

  • 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.

  • 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 das vorläufige 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.

  • 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.

  • Sie können Buckets, die vorläufig gelöscht wurden, nicht wiederherstellen, wenn der hierarchische Namespace aktiviert ist.

  • Tagbindungen 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 weich 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 Buckets in Ihrem Projekt auf:

Befehlszeile

Verwenden Sie den Befehl gcloud storage ls, um alle vorläufig gelöschten Bucket 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-Datei finden Sie unter Vorübergehend 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-Datei finden Sie unter Vorübergehend 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