View a markdown version of this page

BUCKET-Lebenszyklus ABRUFEN (veraltet) - Amazon Simple Storage Service
DescriptionAnforderungenAntwortenSpezielle FehlerBeispieleVerwandte Ressourcen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

BUCKET-Lebenszyklus ABRUFEN (veraltet)

Description

Wichtig

Eine aktualisierte Version dieser API finden Sie unter GetBucketLifecycleConfiguration. Wenn Sie mithilfe des <filter>Elements einen Bucket-Lebenszyklus konfiguriert haben, sollten Sie eine aktualisierte Version dieses Themas sehen. Dieses Thema dient der Abwärtskompatibilität.

Gibt die für den Bucket festgelegten lifecycle Konfigurationsinformationen zurück. Informationen zur Lifecycle-Konfiguration finden Sie im Amazon Simple Storage Service-Benutzerhandbuch unter Object Lifecycle Management.

Um diesen Vorgang verwenden zu können, benötigen Sie die Berechtigung zum Ausführen der s3:GetLifecycleConfiguration Aktion. Der Bucket-Besitzer hat diese Berechtigung standardmäßig. Der Bucket-Besitzer kann diese Erlaubnis anderen gewähren. Weitere Informationen zu Berechtigungen finden Sie unter Verwalten von Zugriffsberechtigungen für Ihre Amazon S3-Ressourcen im Amazon Simple Storage Service-Benutzerhandbuch.

Anforderungen

Syntax

GET /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Date: date
Authorization: authorization string (see Anfragen authentifizieren (AWS Signatur (Version 4))

Anforderungsparameter

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

Anforderungsheader

Diese Implementierung des Vorgangs verwendet nur Anforderungsheader, die allen Vorgängen gemeinsam sind. Weitere Informationen finden Sie unter Allgemeine Anforderungsheader.

Anfrage-Elemente

Diese Implementierung des Vorgangs verwendet keine Anforderungselemente.

Antworten

Antwort-Header

Diese Implementierung des Vorgangs verwendet nur Antwortheader, die den meisten Antworten gemeinsam sind. Weitere Informationen finden Sie unter Allgemeine Antwortheader.

Antwortelemente

Diese Implementierung von GET gibt die folgenden Antwortelemente zurück.

Name Description Erforderlich
AbortIncompleteMultipartUpload Container zur Angabe, wann ein unvollständiger mehrteiliger Upload für einen Abbruchvorgang in Frage kommt.

Untergeordnet: DaysAfterInitiation

Typ: Container

Vorfahr: Rule

 Ja, wenn für die Regel keine andere Aktion angegeben ist
Date

Datum, an dem Amazon S3 die Aktion ausführen soll. Weitere Informationen finden Sie unter Lebenszyklusregeln: Basierend auf einem bestimmten Datum im Amazon Simple Storage Service-Benutzerhandbuch.

Der Datumswert muss konform zum Format ISO 8601 angegeben werden. Die Uhrzeit ist stets Mitternacht UTC.

Typ: Zeichenfolge

Vorfahr: Expiration oder Transition

 Ja, wenn Days und ExpiredObjectDeleteMarker sind abwesend
Days

Gibt die Anzahl der Tage nach der Objekterstellung an, an denen die spezifische Regelaktion wirksam wird. Die Zulassungszeit des Objekts wird als Erstellungszeit plus Anzahl der Tage berechnet, wobei die resultierende Zeit auf Mitternacht UTC des nächsten Tages gerundet wird.

Typ: Non-negative Ganzzahl bei Verwendung mitTransition, positive Ganzzahl bei Verwendung mitExpiration.

Vorfahr: Transition oder Expiration

 Ja, wenn Date und ExpiredObjectDeleteMarker sind abwesend
DaysAfterInitiation

Gibt an, wie viele Tage nach dem Initiieren eines mehrteiligen Uploads der mehrteilige Upload abgeschlossen sein muss. Wenn der Vorgang nicht innerhalb der angegebenen Anzahl von Tagen abgeschlossen ist, kann ein Vorgang abgebrochen werden, und Amazon S3 storniert den unvollständigen mehrteiligen Upload.

Typ: Positive Ganzzahl

Vorfahr: AbortIncompleteMultipartUpload

 Ja, wenn es abwesend Date ist
Expiration

Diese Aktion gibt einen Zeitraum in der Lebensdauer des Objekts an, in dem Amazon S3 die entsprechende Ablaufmaßnahme ergreifen soll. Die Ablaufaktion wird nur für Objekte ausgeführt, die gemäß dem im untergeordneten Days Element Date oder Element angegebenen Zeitraum in Frage kommen. Die Aktion, die Amazon S3 ergreift, hängt davon ab, ob für den Bucket die Versionierung aktiviert ist.

  • Wenn die Versionierung für den Bucket noch nie aktiviert wurde, löscht Amazon S3 die einzige Kopie des Objekts dauerhaft.

  • Andernfalls gilt die Aktion nur für die aktuelle Version des Objekts, wenn für Ihren Bucket die Versionierung aktiviert ist (oder die Versionierung ausgesetzt ist). Buckets, für die die Versionierung aktiviert oder für die die Versionierung gesperrt ist, können viele Versionen desselben Objekts enthalten: eine aktuelle Version und keine oder mehrere nicht aktuelle Versionen.

    Anstatt die aktuelle Version zu löschen, macht Amazon S3 sie zu einer nicht aktuellen Version, indem eine Löschmarkierung als neue aktuelle Version hinzugefügt wird.

    Wichtig

    Wenn der Status eines Buckets „Version-Suspended“ lautet, erstellt Amazon S3 eine Löschmarkierung mit der Versions-ID. null Wenn Sie eine Version mit Versions-ID habennull, überschreibt Amazon S3 diese Version.

    Anmerkung

    Um das Ablaufdatum für nicht aktuelle Objekte festzulegen, müssen Sie die NoncurrentVersionExpiration Aktion verwenden.

Typ: Container

Kinder: Tage oder Datum

Vorfahr: Regel

 Ja, wenn das übergeordnete Tag angegeben ist
ID

Ein eindeutiger Bezeichner für die Regel. Der Wert darf nicht länger als 255 Zeichen sein.

Typ: Zeichenfolge

Vorfahr: Regel

 Nein
LifecycleConfiguration

Container für Lebenszyklusregeln. Sie können bis zu 1000 Regeln hinzufügen.

Typ: Container

Kinder: Regel

Vorfahr: Keiner

 Ja
ExpiredObjectDeleteMarker

In einem versionierten Bucket (Bucket mit Versionierung oder Bucket mit Versionierung suspendiert) gibt dieses Element an, ob Amazon S3 alle Markierungen zum Löschen abgelaufener Objekte im Bucket löscht. Ein Beispiel finden Sie im Amazon Simple Storage Service-Benutzerhandbuch unter Beispiel 8: Ablaufaktion angeben, um Markierungen zum Löschen abgelaufener Objekte zu entfernen.

Typ: Zeichenfolge

Gültige Werte: true | false (der Wert false ist zulässig, aber es handelt sich um einen No-Op, Amazon S3 ergreift keine Maßnahmen, wenn der Wert falsch ist)

Vorfahr: Expiration

 Ja, wenn Date und Days sind abwesend
NoncurrentDays

Gibt die Anzahl der Tage an, an denen ein Objekt nicht aktuell ist, bevor Amazon S3 die zugehörige Aktion ausführen kann. Informationen zur Berechnung nicht aktueller Tage finden Sie unter Lebenszyklusregeln auf der Grundlage der Anzahl der Tage im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Nicht negative Ganzzahl bei Verwendung in KombinationNoncurrentVersionTransition, positive Ganzzahl bei Verwendung mit NoncurrentVersionExpiration

Vorfahr: oder NoncurrentVersionExpiration NoncurrentVersionTransition

 Ja, nur wenn der Vorfahr anwesend ist
NoncurrentVersionExpiration

Gibt an, wann nicht-aktuelle Objektversionen ablaufen. Nach Ablauf löscht Amazon S3 permanent die nicht-aktuellen Objektversionen.

Stellen Sie diese Lebenszyklus-Konfigurationsaktion für einen Bucket ein, für den die Versionierung aktiviert (oder ausgesetzt) ist, um Amazon S3 aufzufordern, nicht aktuelle Objektversionen zu einem bestimmten Zeitraum in der Lebensdauer des Objekts zu löschen.

Typ: Container

Kinder: NoncurrentDays

Vorfahr: Regel

 Ja, wenn keine andere Aktion in der Rule
NoncurrentVersionTransition

Container für die Übergangsregel, die beschreibt, wann nicht aktuelle Objekte in die STANDARD_IAONEZONE_IA, oder die Speicherklasse übergehen.

Wenn Ihr Bucket für die Versionierung aktiviert ist (oder die Versionierung unterbrochen ist), können Sie diese Aktion so einrichten, dass Amazon S3 aufgefordert wird, nicht aktuelle Objektversionen zu einem bestimmten Zeitpunkt in der Lebensdauer des Objekts auf die Speicherklasse umzustellen.

Typ: Container

Kinder: und NoncurrentDays StorageClass

Vorfahr: Regel

 Ja, wenn keine andere Aktion in der Rule
Prefix

Objektschlüsselpräfix, das ein oder mehrere Objekte identifiziert, für die die Regel gilt.

Typ: Zeichenfolge

Vorfahr: Regel

 Ja
Rule

Container für eine Lebenszyklusregel.

Typ: Container

Vorfahr: LifecycleConfiguration

 Ja
Status

Wenn aktiviert, führt Amazon S3 die Regel wie geplant aus. Wenn deaktiviert, ignoriert Amazon S3 die Regel.

Typ: Zeichenfolge

Ancestor: Regel

Gültige Werte: Aktiviert oder Deaktiviert

 Ja
StorageClass

Gibt die Amazon S3-Speicherklasse an, zu der Sie das Objekt übertragen möchten.

Typ: Zeichenfolge

Ancestor: Übergang und NoncurrentVersionTransition

Gültige Werte: STANDARD_IA | | ONEZONE_IA

Ja
Transition

Diese Aktion gibt einen Zeitraum in der Lebensdauer der Objekte an, in dem Amazon S3 sie in die SpeicherklasseSTANDARD_IA,ONEZONE_IA, oder umstellen soll. Wenn diese Aktion in Kraft ist, hängt das, was Amazon S3 tut, davon ab, ob der Bucket versionierungsfähig ist.

  • Wenn die Versionierung für den Bucket noch nie aktiviert wurde, überträgt Amazon S3 die einzige Kopie des Objekts in die angegebene Speicherklasse.

  • Wenn für Ihren Bucket die Versionierung aktiviert ist (oder die Versionierung ausgesetzt ist), überträgt Amazon S3 nur die aktuellen Versionen der in der Regel identifizierten Objekte.

    Anmerkung

    Ein Bucket mit aktivierter oder gesperrter Versionierung kann viele Versionen eines Objekts enthalten. Diese Aktion hat keine Auswirkung auf die nicht aktuellen Objektversionen. Um nicht aktuelle Objekte zu übertragen, müssen Sie die NoncurrentVersionTransition Aktion verwenden.

Typ: Container

Kinder: Tage oder Datum und StorageClass

Vorfahr: Regel

 Ja, wenn keine andere Aktion in der Rule

Spezielle Fehler

Fehlercode Description HTTP-Statuscode SOAP-Fehlercode-Präfix
NoSuchLifecycleConfiguration Die Lebenszykluskonfiguration ist nicht vorhanden. 404 Not Found (404 Nicht gefunden) Client

Allgemeine Informationen zu Amazon S3-Fehlern und eine Liste von Fehlercodes finden Sie unterFehlermeldungen.

Beispiele

Beispiel 1: Rufen Sie eine Lifecycle-Unterressource ab

Dieses Beispiel ist eine GET-Anforderung zum Abrufen der lifecycle Unterressource aus dem angegebenen Bucket und eine Beispielantwort mit der zurückgegebenen Lebenszykluskonfiguration.

Beispielanforderung

GET /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com
x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
Authorization: signatureValue

Beispielantwort

HTTP/1.1 200 OK
x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
x-amz-request-id: 51991C342C575321
Date: Thu, 15 Nov 2012 00:17:23 GMT
Server: AmazonS3
Content-Length: 358

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Rule>
        <ID>Archive and then delete rule</ID>
        <Prefix>projectdocs/</Prefix>
        <Status>Enabled</Status>
       <Transition>
           <Days>30</Days>
           <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
        <Transition>
           <Days>365</Days>
           <StorageClass>GLACIER</StorageClass>
        </Transition>
        <Expiration>
           <Days>3650</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>