Buckets mit vorläufig gelöschten Elementen verwenden

Übersicht über die Funktion „Vorläufig löschen“

Auf dieser Seite wird beschrieben, wie Sie vorläufig gelöschte Buckets 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 und kann im Status „vorläufig gelöscht“ 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 in den Status „Live“ zurückgesetzt. 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 beibehalten wurde.

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

  • Wenn Sie einen vorläufig gelöschten Bucket mit der gcloud CLI oder der JSON API wiederherstellen, werden die Objekte im Bucket nicht wiederhergestellt. Wenn Sie vorläufig gelöschte Objekte wiederherstellen möchten, müssen Sie nach der Wiederherstellung des vorläufig gelöschten Buckets einen Objektwiederherstellungsvorgang 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 erforderlich, um vorläufig gelöschte Buckets wiederherzustellen:

  • storage.buckets.list
  • storage.buckets.restore
  • So stellen Sie Objekte wieder her, wenn Sie die Google Cloud Console verwenden, um einen vorläufig gelöschten Bucket wiederherzustellen:
    • storage.objects.restore
    • storage.objects.create

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 die vorläufig gelöschten Buckets in Ihrem Projekt auf:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie auf Ansichtsoptionen.

  3. Wählen Sie Nur vorläufig gelöschte Buckets aus.

  4. Klicken Sie auf Speichern.

    Eine Liste der vorläufig gelöschten Buckets wird angezeigt. Wenn ein vorläufig gelöschter Bucket mehrere Generationen hat, wird jede Bucket-Generation in einer separaten Zeile angezeigt.

Befehlszeile

Verwenden Sie den Befehl gcloud storage ls, um vorläufig gelöschte 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:

Wenn Sie einen vorläufig gelöschten Bucket über die Google Cloud Konsole wiederherstellen, können Sie auch die vorläufig gelöschten Objekte wiederherstellen, die sich im Bucket befanden.

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Vorläufig gelöschte Buckets in der Bucket-Liste anzeigen, falls sie noch nicht angezeigt werden. Eine Anleitung finden Sie unter Vorläufig gelöschte Buckets auflisten.

  3. Klicken Sie in der Zeile für den Bucket, den Sie wiederherstellen möchten, auf Wiederherstellen.

  4. Wenn der Bucket mehrere Generationen hat, wählen Sie auf dem Tab Bucket-Generation angeben die Generation aus, die wiederhergestellt werden soll.

  5. Klicken Sie auf den Tab Wiederherzustellende Objekte angeben.

  6. Wählen Sie im Abschnitt Wiederherzustellende Objekte angeben aus, ob Sie die vorläufig gelöschten Objekte wiederherstellen möchten, die sich im Bucket befanden. Folgende Optionen sind verfügbar:

    • Objekte nicht wiederherstellen:

      Sie können vorläufig gelöschte Objekte bei Bedarf später wiederherstellen.

    • Alle Objekte wiederherstellen

    • Objekte wiederherstellen, die bestimmten Kriterien entsprechen Gehen Sie dazu so vor:

      1. Wählen Sie den Zeitraum aus, aus dem Sie Objekte wiederherstellen möchten.

      2. Optional: Wenn Sie nur die Objekte wiederherstellen möchten, die einem Glob-Muster entsprechen, wählen Sie Nach Glob-Muster filtern aus und geben Sie ein Glob-Muster ein.

  7. Optional: Geben Sie im Abschnitt Zusätzliche Optionen zusätzliche Wiederherstellungsverhaltensweisen an.

  8. Klicken Sie auf Wiederherstellen.

    Cloud Storage stellt den vorläufig gelöschten Bucket in einem Live-Zustand wieder her.

    Wenn Sie die Objekte im Bucket wiederherstellen, erstellt Cloud Storage einen Bulk-Wiederherstellungsvorgang für die Objekte. Der Vorgang erfolgt asynchron und kann eine Stunde oder länger dauern. Sie können den Fortschritt des Vorgangs verfolgen. Klicken Sie dazu im Google Cloud Console-Header auf die Schaltfläche Benachrichtigungen (). Alternativ können Sie den Status des zugehörigen Vorgangs mit langer Ausführungszeit mit der gcloud CLI verfolgen.

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.

Cloud Storage stellt den vorläufig gelöschten Bucket in einem Live-Zustand wieder her. Durch das Wiederherstellen des Buckets werden die Objekte, die sich im Bucket befanden, nicht wiederhergestellt. Informationen zum Wiederherstellen vorläufig gelöschter Objekte finden Sie unter Vorläufig gelöschtes Objekt wiederherstellen.

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. Hinweis: Durch das Wiederherstellen des Buckets werden die Objekte, die sich im Bucket befanden, nicht wiederhergestellt. Informationen zum Wiederherstellen vorläufig gelöschter Objekte finden Sie unter Vorläufig gelöschtes Objekt wiederherstellen.

Nächste Schritte