Vorläufig gelöschte Buckets verwenden

Übersicht über die Funktion für vorläufiges 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 des endgültigen Löschens ist mindestens so lange wie der späteste Zeitpunkt des endgültigen Löschens der Objekte des Buckets. Nach Ablauf des Zeitpunkts des endgültigen Löschens löscht Cloud Storage den Bucket endgültig. Wenn Sie einen vorläufig gelöschten Bucket wiederherstellen, wird er wieder in den Live-Status 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 das vorläufige Löschen aufbewahrt 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 Generierungsnummer des Buckets. Informationen zum Abrufen der Generierungsnummer eines vorläufig gelöschten Buckets, siehe Vorläufig gelöschte Buckets auflisten.

  • Ein vorläufig gelöschter Bucket kann nur wiederhergestellt werden, wenn kein Live-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. Um vorläufig gelöschte Objekte wiederherzustellen, müssen Sie nach der Wiederherstellung des vorläufig gelöschten Buckets einen Objektwiederherstellungsvorgang durchführen.

  • Tag-Bindungen können möglicherweise nicht wiederhergestellt werden, wenn Sie einen vorläufig gelöschten Bucket mit Tags wiederherstellen. Um Datenverlust zu vermeiden, empfehlen wir, nach der Wiederherstellung 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 Admin (roles/storage.admin) für das Cloud Storage-Projekt zuzuweisen, um die erforderlichen Berechtigungen zum Wiederherstellen vorläufig gelöschter Buckets zu erhalten.

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

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um vorläufig gelöschte Buckets wiederherzustellen:

  • storage.buckets.list
  • storage.buckets.restore
  • Objekte wiederherstellen, 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 Optionen ansehen.

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

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

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI installiert und initialisiert, um ein Zugriffstoken für den Authorization Header zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer Buckets: list-Anfrage aufzurufen, die den Abfrage parameter verwendet:softDeleted

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

    Ersetzen Sie PROJECT_IDENTIFIER durch die ID oder Nummer des Projekts, das die vorläufig gelöschten Buckets enthält, die Sie auflisten möchten.

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 Console 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. Zeigen Sie vorläufig gelöschte Buckets in der Liste der Buckets an, 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 Sie wiederherstellen möchten.

  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 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 weitere Wiederherstellungsverhaltensweisen an.

  8. Klicken Sie auf Wiederherstellen.

    Cloud Storage versetzt den vorläufig gelöschten Bucket wieder in den Live-Status.

    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, bis er gestartet wird. Sie können den Fortschritt des Vorgangs verfolgen. Klicken Sie dazu im Header der Google Cloud Console auf die Schaltfläche Benachrichtigungen (). Alternativ können Sie mit der gcloud CLI den Status des zugehörigen Vorgangs mit langer Ausführungszeit verfolgen.

Befehlszeile

Verwenden Sie den gcloud storage restore Befehl, 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 Generierungsnummer Ihres Buckets finden Sie unter Vorläufig gelöschte Buckets auflisten.

Cloud Storage versetzt den vorläufig gelöschten Bucket wieder in den Live-Status. Beachten Sie, dass durch die Wiederherstellung des Buckets die Objekte, die sich im Bucket befanden, nicht wiederhergestellt werden. Informationen zum Wiederherstellen vorläufig gelöschter Objekte finden Sie unter Vorläufig gelöschtes Objekt wiederherstellen.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI installiert und initialisiert, um ein Zugriffstoken für den Authorization Header zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer Buckets: restore-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 Generierungsnummer Ihres Buckets finden Sie unter Vorläufig gelöschte Buckets auflisten.

    Cloud Storage versetzt den vorläufig gelöschten Bucket wieder in den Live-Status. Beachten Sie, dass durch die Wiederherstellung des Buckets die Objekte, die sich im Bucket befanden, nicht wiederhergestellt werden. Informationen zum Wiederherstellen vorläufig gelöschter Objekte finden Sie unter Vorläufig gelöschtes Objekt wiederherstellen.

Nächste Schritte