Vorläufig gelöschte Objekte verwenden

Auf dieser Seite wird beschrieben, wie Sie vorläufig gelöschte Objekte auflisten, aufrufen und wiederherstellen.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Storage-Administrator (roles/storage.admin) für den Bucket, verwalteten Ordner oder das Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Auflisten, Aufrufen und Wiederherstellen vorläufig gelöschter Objekte benötigen.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Auflisten, Aufrufen und Wiederherstellen vorläufig gelöschter Objekte 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 Objekte aufzulisten, aufzurufen und wiederherzustellen:

storage.buckets.get
storage.buckets.update
storage.buckets.list (Diese Berechtigung ist nur erforderlich, um die Aufgaben auf dieser Seite mit der Google Cloud Console auszuführen)
storage.objects.restore
storage.objects.create
storage.objects.delete (Diese Berechtigung ist nur für die Art der Wiederherstellung von Objekten erforderlich, bei der vorhandene Objekte überschrieben werden.)
storage.buckets.restore (Diese Berechtigung ist nur für die Bulk-Wiederherstellung von vorläufig gelöschten Objekten erforderlich)

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

Um lang andauernde Vorgänge zu verwalten, die über Methoden zum vorläufigen Löschen initiiert werden, benötigen Sie möglicherweise zusätzliche Rollen und Berechtigungen. Weitere Informationen finden Sie unter Erforderliche Rollen für Vorgänge mit langer Ausführungszeit.

Alle vorläufig gelöschten Objekte in einem Bucket auflisten

Sie können alle vorläufig gelöschten Objekte in einem Bucket auflisten.

Console

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

Buckets aufrufen
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie die vorläufig gelöschten Objekte aufrufen möchten. Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
Wählen Sie in der Liste Anzeigen die Option Nur vorläufig gelöschte Objekte aus. Eine Liste der vorläufig gelöschten Objekte wird angezeigt.

Befehlszeile

Wenn Sie eine Liste aller vorläufig gelöschten Objekte in einem Bucket aufrufen möchten, verwenden Sie den Befehl gcloud storage ls mit den Flags --soft-deleted und --recursive:

  gcloud storage ls gs://BUCKET_NAME --soft-deleted --recursive

Ersetzen Sie Folgendes:

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

REST APIs

JSON API

Installieren und initialisieren Sie die dcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.

Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header Authorization einfügen.

MitcURL dieJSON-API mit einerAnfrage zum Auflisten von Objekten aufrufen, die den ?softDeleted-Abfrageparameter verwenden:

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/o?softDeleted=true"

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

Alle vorläufig gelöschten Versionen eines Objekts ansehen

Sie können sich alle vorläufig gelöschten Versionen eines bestimmten Objekts in Ihrem Bucket ansehen.

Console

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

Buckets aufrufen
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der das Objekt enthält, für das Sie vorläufig gelöschte Versionen aufrufen möchten. Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
Klicken Sie auf das Objekt, von dem Sie alle vorläufig gelöschten Versionen aufrufen möchten. Die Seite Objektdetails wird angezeigt.
Klicken Sie auf den Tab Versionsverlauf.
Wählen Sie in der Liste Anzeigen die Option Nur vorläufig gelöschte Objekte aus. Eine Liste aller vorläufig gelöschten Versionen für dieses Objekt wird angezeigt.

Befehlszeile

Verwenden Sie den Befehl gcloud storage ls, um eine Liste aller vorläufig gelöschten Versionen eines Objekts in einem Bucket aufzurufen:

  gcloud storage ls gs://BUCKET_NAME/OBJECT_NAME --soft-deleted

Ersetzen Sie Folgendes:

BUCKET_NAME: der Name des Buckets. Beispiel: my-bucket
OBJECT_NAME: der Name des Objekts, dessen Versionen Sie aufrufen möchten.

REST APIs

JSON API

Installieren und initialisieren Sie die dcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.

Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header Authorization einfügen.
MitcURL dieJSON-API mit einerAnfrage zum Auflisten von Objekten aufrufen, die den ?softDeleted-Abfrageparameter verwenden:
```
curl -X GET \
  -H "Authorization: Bearer OAUTH2_TOKEN" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o?matchGlob=OBJECT_NAME&softDeleted=true"
```
Ersetzen Sie Folgendes:
- BUCKET_NAME: der Name des Buckets. Beispiel: my-bucket
- OBJECT_NAME: der Name des Objekts für das Sie alle Versionen abrufen möchten.

Vorläufig gelöschtes Objekt wiederherstellen

Sie können eine bestimmte Version eines vorläufig gelöschten Objekts in Ihrem Bucket wiederherstellen.

Console

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

Buckets aufrufen
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der die vorläufig gelöschten Objekte enthält, die Sie wiederherstellen möchten. Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
Wählen Sie in der Liste Anzeigen die Option Nur vorläufig gelöschte Objekte aus.
Wechseln Sie zu dem Objekt. Dieses befindet sich möglicherweise in einem Ordner.
Klicken Sie auf das vorläufig gelöschte Objekt. Die Seite Objektdetails wird angezeigt.
Wählen Sie in der Liste Anzeigen die Option Nur vorläufig gelöschte Objekte aus. Eine Liste aller vorläufig gelöschten Versionen dieses Objekts wird angezeigt.
Wenn Sie eine bestimmte vorläufig gelöschte Version eines Objekts wiederherstellen möchten, klicken Sie neben dieser Objektversion auf Wiederherstellen. Der Bereich der Objektwiederherstellung wird geöffnet.
Klicken Sie auf Bestätigen.

Befehlszeile

Verwenden Sie den Befehl gcloud storage restore, um eine vorläufig gelöschte Version eines Objekts wiederherzustellen:

  gcloud storage restore gs://BUCKET_NAME/OBJECT_NAME#GENERATION_NUMBER

Ersetzen Sie Folgendes:

BUCKET_NAME: der Name des Buckets. Beispiel: my-bucket
OBJECT_NAME: Name des Objekts, für das Sie alle Versionen aufrufen möchten.
GENERATION_NUMBER: die Generierungsnummer des vorläufig gelöschten Objekts, das Sie wiederherstellen möchten. Wenn Sie keine Generierungsnummer angeben, wird die neueste Version wiederhergestellt. Beispiel: 1560468815691234.

Weitere Optionen für die Wiederherstellung mehrerer Objekte im Bulk, einschließlich der Wiederherstellung aller Versionen eines Objekts mit dem Flag all-versions, finden Sie in der Referenz zu gcloud storage restore.

REST APIs

JSON API

Installieren und initialisieren Sie die dcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.

Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header Authorization einfügen.
Verwenden Sie cURL, um die JSON API mit einer POST-Objektanfrage 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/o/OBJECT_NAME/restore?generation=GENERATION_NUMBER"
```
Dabei gilt:
- BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.
- OBJECT_NAME ist der Name des vorläufig gelöschten Objekts, das Sie wiederherstellen möchten. Beispiel: cat.jpeg.
- GENERATION_NUMBER ist die Generierungsnummer des vorläufig gelöschten Objekts, das Sie wiederherstellen möchten. Wenn Sie keine Generierungsnummer angeben, wird die neueste Version wiederhergestellt. Beispiel: 1560468815691234

Vorläufig gelöschte Objekte in einem Bucket im Bulk wiederherstellen

Verwenden Sie einen Bulk-Wiederherstellungsvorgang, wenn Sie eine große Anzahl von Objekten wiederherstellen möchten oder die einzelnen Objekte, die Sie wiederherstellen möchten, nicht kennen. Beachten Sie, dass Bulk-Wiederherstellungsvorgänge asynchron erfolgen und in einigen Fällen eine Stunde oder länger dauern können.

Der Bulk-Wiederherstellungsvorgang initiiert einen lang andauernden Vorgang für einen Bucket. Mit der Google Cloud CLI können Sie Vorgänge mit langer Ausführungszeit abrufen und auflisten, um die Details und den Status des Bulk-Wiederherstellungsvorgangs anzuzeigen, während er ausgeführt wird.

Console

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

Buckets aufrufen
Suchen Sie in der Liste der Buckets den Bucket mit den Objekten, die Sie wiederherstellen möchten.
Klicken Sie auf das Dreipunkt-Menü () des Buckets und wählen Sie Wiederherstellungsjob erstellen aus.

Der Bereich Job wiederhererstellen wird geöffnet.
Wählen Sie im Abschnitt Auswählen, welche vorläufig gelöschten Objekte wiederhergestellt werden sollen den Löschzeitraum aus, aus dem Sie Objekte wiederherstellen möchten.
(Optional) Wählen Sie Nach glob-Muster filtern aus und geben Sie ein Glob-Muster ein, um nur Objekte wiederherzustellen, die die Kriterien des Glob-Musters erfüllen.
(Optional) Aktivieren Sie im Abschnitt Wiederherstellungsoptionen zusätzliche Wiederherstellungsverhaltensweisen.
Klicken Sie auf Erstellen.

Sie können den Fortschritt Ihres Bulk-Wiederherstellungsvorgangs verfolgen. Klicken Sie dazu im Google Cloud Console-Header auf die Schaltfläche Benachrichtigungen ().

Befehlszeile

Wenn Sie mit der Bulk-Wiederherstellung alle Objekte in einem Bucket wiederherstellen möchten, verwenden Sie den Befehl gcloud storage restore.

Der folgende Befehl führt einen Bulk-Wiederherstellungsvorgang aus, um alle Objekte des Buckets, die während eines bestimmten Zeitraums gelöscht wurden, asynchron wiederherzustellen:

  gcloud storage restore gs://BUCKET_NAME/** \
      --async --deleted-after-time=DELETED_AFTER_TIME \
      --deleted-before-time=DELETED_BEFORE_TIME

Ersetzen Sie Folgendes:

BUCKET_NAME: der Name des Buckets. Beispiel: my-bucket
DELETED_AFTER_TIME: ein optionales Argument zur Angabe des Datums, nach dem die Objekte wiederhergestellt werden. Beispiel: 2022-12-01
DELETED_BEFORE_TIME: ein optionales Argument zur Angabe des Datums, vor dem die Objekte wiederhergestellt werden. Beispiel: 2022-12-21

Bei Erfolg gibt der Befehl die ID des Vorgangs mit langer Ausführungszeit zurück, der dem Bulk-Wiederherstellungsvorgang zugeordnet ist. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen oder den Vorgang mit langer Ausführungszeit abbrechen, um den Bulk-Wiederherstellungsvorgang zu beenden, bevor er abgeschlossen ist. Weitere Informationen finden Sie unter Vorgänge mit langer Laufzeit verwenden.

REST APIs

JSON API

Installieren und initialisieren Sie die dcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.

Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header Authorization einfügen.

Verwenden Sie cURL, um die JSON API mit einer POST-Objektanfrage 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/o/bulkRestore"

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

Bei Erfolg gibt der Befehl die ID des Vorgangs mit langer Ausführungszeit zurück, der dem Bulk-Wiederherstellungsvorgang zugeordnet ist. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen oder den Vorgang mit langer Ausführungszeit abbrechen, um den Bulk-Wiederherstellungsvorgang zu beenden, bevor er abgeschlossen ist. Weitere Informationen finden Sie unter Vorgänge mit langer Ausführungszeit verwenden.

Vorgänge mit langer Ausführungszeit für die Bulk-Wiederherstellung verwenden

Der Bulk-Wiederherstellungsvorgang initiiert einen Vorgang mit langer Ausführungszeit. Sie können Vorgänge mit langer Ausführungszeit abrufen und auflisten, um Details und Status eines Bulk-Wiederherstellungsvorgangs anzusehen oder einen Vorgang mit langer Ausführungszeit löschen, um eine Bulk-Wiederherstellung während der Ausführung abzubrechen.

Eine Anleitung zur Verwendung von Vorgängen mit langer Ausführungszeit, die durch Vorgänge in Cloud Storage initiiert wurden, darunter Bulk-Wiederherstellungsvorgänge, finden Sie unter Vorgänge mit langer Ausführungszeit verwenden.

Das folgende Beispiel zeigt einen Vorgang mit langer Ausführungszeit, der von einem Bulk-Wiederherstellungsvorgang zurückgegeben wird:

done: false
{
  "kind": "storage@operation",
  "name": "projects/_/buckets/my-bucket/operations/CiQyODRlMTY0My0wNGExLTQ3MWItOTE2Zi1hZmQ0ZmM4ZDc4MjQQAg",
  "metadata": {
    "@type": "type.googleapis.com/google.storage.v2.BulkRestoreObjectsMetadata",
    "commonMetadata": {
      "type": "bulk-restore-objects",
      "createTime": "2023-10-20T21:08:11.289Z",
      "updateTime": "2023-10-20T21:18:37.583Z",
      "endTime": "2023-10-20T21:18:37.583Z",
      "requestedCancellation": false,
      "progressPercent": -1,
    },
    "allow_overwrite": false,
    "matchGlobs": ["*"],
    "succeededCount": "0",
    "failedCount": "0",
    "skippedCount": "0",
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.storage.v2.BulkRestoreObjectsResponse"
  }
}

Nächste Schritte

Weitere Informationen zum vorläufigen Löschen