Bucket-Lebenszyklus abrufen

Zum Auflisten der Lebenszykluskonfiguration eines Buckets senden Sie eine GET-Anfrage, die für einen Bucket gilt, und den Abfragestringparameter lifecycle verwenden. Die Lebenszykluskonfiguration wird in einem XML-Dokument im Antworttext zurückgegeben.

Abfragestringparameter

Parameter Beschreibung Erforderlich
lifecycle Damit können Sie die Lebenszykluskonfiguration eines vorhandenen Buckets anzeigen lassen. Nein

Informationen zu den Parametern, die Sie beim Erstellen und Verwenden signierter URLs angeben müssen, finden Sie unter Stringparameter für signierte URLs.

Anfrageheader

Siehe Allgemeine Anfrageheader.

Anfragetextelemente

Die Anfrage enthält kein XML-Dokument im Anfragetext.

Anfragesyntax

Die folgende Syntax gilt für GET-Bucket-Anfragen, die den Abfragestringparameter lifecycle verwenden.

GET /?lifecycle HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

Antwortheader

Die Anfrage kann je nach verwendetem Anfrage-Header eine Vielzahl von Antwort-Headern zurückgeben.

Antworttextelemente

Die folgenden Antworttextelemente sind nur anwendbar, wenn Sie den Abfragestringparameter lifecycle zur Anzeige der Lebenszykluskonfiguration des Buckets verwenden.

Element Beschreibung
LifecycleConfiguration Definiert die Richtlinien für die Lebenszyklusverwaltung für den Bucket, die 0 oder mehr (bis zu 100) Regeln enthalten. Ein leeres Element (z. B. <LifecycleConfiguration/>) bedeutet, dass die Lebenszyklusverwaltung für den Bucket nicht aktiviert ist.
Rule Definiert eine Lebenszyklusverwaltungsregel, die aus einer Aktion und den Bedingungen besteht, die erfüllt sein müssen, damit die Aktion ausgeführt wird.
Action Definiert die Aktion, die erfolgen soll, wenn die angegebenen Bedingungen erfüllt sind.
Delete Aktionselement zum Löschen von Objekten im Bucket.
SetStorageClass Aktionselement, um die Speicherklasse von Objekten im Bucket zu ändern.
Condition Bedingungen, die erfüllt sein müssen, damit die Aktion ausgeführt wird. Jede Regel enthält mindestens ein Bedingungselement.
Age Bedingungselement, das mit Objekten über das angegebene Alter (in Tagen) übereinstimmt
CreatedBefore Bedingungselement, das mit Objekten übereinstimmt, die vor Mitternacht des angegebenen Datums in UTC erstellt wurden. Der Wert ist ein ISO-Datumsstring ohne Zeitzone, z.B. 2019-01-15.
CustomTimeBefore Bedingungselement, das mit Objekten übereinstimmt, deren Custom-Time-Metadaten ein Datum enthalten, das vor dem von dieser Bedingung festgelegten Datum liegt CustomTimeBefore ist ein ISO-Datumsstring ohne Zeitzone, z.B. 2020-02-25.
DaysSinceCustomTime Bedingungselement, das mit Objekten übereinstimmt, deren Custom-Time-Metadaten älter als DaysSinceCustomTime Tage sind
DaysSinceNoncurrentTime Bedingungselement, das nur für versionierte Objekte relevant ist. Gleicht Objekte ab, die seit längerer Zeit nicht mehr aktuell sind.
IsLive Das Bedingungselement wird normalerweise nur in Verbindung mit der Objektversionsverwaltung verwendet. Bei der Einstellung false ist diese Bedingung für jede nicht aktuelle Version eines Objekts erfüllt. Beim Wert true ist diese Bedingung für die Live-Version eines Objekts erfüllt. Wenn Sie die Objektversionsverwaltung nicht verwenden, werden alle Objekte als live betrachtet und übereinstimmen, wenn IsLive true ist.
MatchesStorageClass Bedingungselement, das mit Objekten der angegebenen Speicherklasse übereinstimmt
NoncurrentTimeBefore Bedingungselement, das nur für versionierte Objekte relevant ist. Gleicht Objekte ab, die an einem Datum vor dem in dieser Bedingung angegebenen Datum nicht aktuell waren. NoncurrentTimeBefore ist ein ISO-Datumsstring ohne Zeitzone, z.B. 2020-02-25.
NumberOfNewerVersions Bedingungselement, das nur für versionierte Objekte relevant ist. Beim Wert N ist die Bedingung erfüllt, wenn mindestens eine N-Version (einschließlich der Live-Version) neuer als diese Version des Objekts ist.