Vorläufig gelöschte Buckets verwenden

Übersicht über die Funktion „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. Die Zeit für das endgültige Löschen ist mindestens so lang wie die letzte Zeit für das endgültige Löschen der Objekte des Buckets. Nach Ablauf der Frist 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 Live-Status 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 dann endgültig gelöscht werden, wenn er für die gesamte Aufbewahrungsdauer für vorläufiges 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.

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

  • Ein vorläufig gelöschter Bucket kann nur wiederhergestellt werden, wenn es keinen Live-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.

  • 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. Wenn Sie einen vorläufig gelöschten Bucket mit Tag-Bindungen wiederherstellen, sollten Sie prüfen, ob die Tag-Bindungen des Buckets wiederhergestellt wurden, um Datenverlust zu vermeiden. 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. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

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 Cloud de Confiance 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 Listenoperationen 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 Cloud de Confiance 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 Befehl gcloud storage ls, 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, 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 Suchparameter softDeleted verwendet:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.s3nsapis.fr/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 Cloud de Confiance Console wiederherstellen, können Sie auch die vorläufig gelöschten Objekte wiederherstellen, die sich im Bucket befanden.

Console

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

    Buckets aufrufen

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

  3. Klicken Sie in der Zeile des Buckets, den Sie wiederherstellen möchten, auf Wiederherstellen.

  4. Wenn der Bucket mehrere Generierungen hat, wählen Sie auf dem Tab Bucket-Generierung angeben die Generierung 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 im Bucket wiederherstellen möchten. 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 mit einem Glob-Muster übereinstimmen, 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 Livestatus 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, indem Sie im Header der Cloud de Confiance Console auf den Button Benachrichtigungen () klicken. Alternativ können Sie die gcloud CLI verwenden, um den Status des zugehörigen Vorgangs mit langer Ausführungszeit zu 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 Generierungsnummer Ihres Buckets finden Sie unter Vorläufig gelöschte Buckets auflisten.

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

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, 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.s3nsapis.fr/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 stellt den vorläufig gelöschten Bucket in einem Livestatus wieder her. Beachten Sie, dass durch das Wiederherstellen des Buckets nicht die Objekte wiederhergestellt werden, die sich im Bucket befanden. Informationen zum Wiederherstellen der vorläufig gelöschten Objekte finden Sie unter Vorläufig gelöschtes Objekt wiederherstellen.

Nächste Schritte