Vorläufig löschen verwenden

Übersicht Nutzung

Auf dieser Seite wird beschrieben, wie Sie die Richtlinie zum weichen Löschen für einen Bucket aktivieren, aktualisieren und den Status prüfen. Informationen zum Auflisten und Wiederherstellen vorläufig gelöschter Objekte finden Sie unter Vorläufig gelöschte Objekte verwenden. Informationen zum Auflisten und Wiederherstellen vorläufig gelöschter Buckets finden Sie unter Vorläufig gelöschte Buckets verwenden. Weitere Informationen zum vorläufigen Löschen finden Sie in der Übersicht. Informationen zum Deaktivieren der Funktion finden Sie unter Vorläufiges Löschen deaktivieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Storage-Administrator (roles/storage.admin) für den Bucket oder das Projekt mit dem Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktivieren und Verwalten von Richtlinien für das vorläufige Löschen benötigen.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aktivieren und Verwalten von Richtlinien für das vorläufige Löschen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Richtlinien für das vorläufige Löschen zu aktivieren und zu verwalten:

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list (ist nur erforderlich, wenn Sie die Google Cloud Console zum Ausführen der Anleitung auf dieser Seite verwenden möchten)

Informationen zum Zuweisen von Rollen finden Sie unter IAM mit Buckets verwenden oder Zugriff auf Projekte verwalten.

Richtlinie für das vorläufige Löschen eines Buckets bearbeiten

Die neue Aufbewahrungsdauer für das vorläufige Löschen gilt nur für Objekte oder Buckets, die Sie nach Inkrafttreten der Richtlinie für das vorläufige Löschen löschen. Vorhandene vorläufig gelöschte Objekte sind von Aktualisierungen der Richtlinie für das vorläufige Löschen nicht betroffen und werden für die Dauer aufbewahrt, die beim Löschen gegolten hat.

So bearbeiten Sie die Richtlinie für das vorläufige Löschen eines Buckets:

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, dessen Richtlinie für das vorläufige Löschen Sie verwalten möchten.

  3. Klicken Sie auf den Tab Schutz.

  4. Führen Sie im Abschnitt Richtlinie für das vorläufige Löschen einen der folgenden Schritte aus:

    • Wenn für den Bucket keine Richtlinie für das vorläufige Löschen festgelegt ist, klicken Sie auf Bearbeiten, wählen Sie eine Zeiteinheit und eine Zeitdauer für die Aufbewahrungsdauer aus und klicken Sie auf Speichern.

    • Wenn für den Bucket eine Richtlinie für das vorläufige Löschen gilt, klicken Sie auf Bearbeiten, um die Zeiteinheit und die Dauer der Aufbewahrungsdauer zu ändern.

Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.

Befehlszeile

Verwenden Sie den Befehl gcloud storage buckets update mit dem Flag --soft-delete-duration, um die Richtlinie für das vorläufige Löschen für einen Bucket hinzuzufügen oder zu ändern:

  gcloud storage buckets update gs://BUCKET_NAME --soft-delete-duration=SOFT_DELETE_DURATION

Dabei gilt:

  • BUCKET_NAME ist der Name des Buckets. Beispiel: my-bucket
  • SOFT_DELETE_DURATION gibt die Dauer an, für die vorläufig gelöschte Objekte aufbewahrt werden sollen. 2w1d entspricht beispielsweise zwei Wochen und einem Tag. Weitere Informationen finden Sie unter Aufbewahrungsdauer für vorläufiges Löschen.

REST APIs

JSON API

  1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

  2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

    {
  "softDeletePolicy": {
    "retentionDurationSeconds": "TIME_IN_SECONDS"
  }
}

    Dabei ist TIME_IN_SECONDS der Zeitraum in Sekunden, in dem vorläufig gelöschte Objekte aufbewahrt werden sollen. Beispiel: 2678400. Weitere Informationen finden Sie unter Aufbewahrungsdauer für vorläufiges Löschen.

  3. Verwenden Sie cURL, um die JSON API mit einer PATCH-Bucket-Anfrage aufzurufen:

    curl -X PATCH --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

    Dabei gilt:

    • JSON_FILE_NAME ist der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
    • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

Prüfen, ob die Richtlinie für vorläufiges Löschen für einen Bucket aktiviert ist

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, dessen Richtlinie für das vorläufige Löschen Sie prüfen möchten.

  3. Klicken Sie auf den Tab Schutz.

    Der Status wird im Abschnitt Richtlinie für vorläufiges Löschen (zur Datenwiederherstellung) angezeigt.

Auf dem Tab Schutz können Sie auch prüfen, ob für Ihren Bucket eine Richtlinie für das vorläufige Löschen gilt.

Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.

Befehlszeile

Verwenden Sie den Befehl gcloud storage buckets describe, um den Status der Richtlinie für das vorläufige Löschen eines Buckets zu prüfen:

  gcloud storage buckets describe gs://BUCKET_NAME \
      --format="default(soft_delete_policy)"

Dabei gilt:

  • BUCKET_NAME ist der Name des Buckets. Beispiel: my-bucket

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/BUCKET_NAME?fields=softDeletePolicy"

    Dabei ist BUCKET_NAME der Name des entsprechenden Buckets. Beispiel: my-bucket.

Nächste Schritte