View a markdown version of this page

PUT-Bucket-Lebenszyklus (veraltet) - Amazon Simple Storage Service
DescriptionAnforderungenAntwortenBeispieleVerwandte 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.

PUT-Bucket-Lebenszyklus (veraltet)

Description

Wichtig

Eine aktualisierte Version dieser API finden Sie unter PutBucketLifecycleConfiguration. Diese Version ist veraltet. Bestehende Lifecycle-Konfigurationen werden funktionieren. Verwenden Sie für neue Lebenszykluskonfigurationen die aktualisierte API.

Erstellt eine Lebenszykluskonfiguration für den Bucket oder ersetzt eine vorhandene Lebenszykluskonfiguration Informationen zur Lebenszykluskonfiguration finden Sie unter Object Lifecycle Management im Amazon Simple Storage Service-Benutzerhandbuch.

Berechtigungen

Standardmäßig sind alle Amazon S3-Ressourcen, einschließlich Buckets, Objekte und zugehörige Unterressourcen (z. B. Lifecycle-Konfiguration und Website-Konfiguration), privat. Nur der Ressourcenbesitzer, der AWS-Konto die Ressource erstellt hat, kann darauf zugreifen. Der Ressourcenbesitzer kann optional anderen Zugriffsberechtigungen gewähren, indem er eine Zugriffsrichtlinie schreibt. Für diesen Vorgang müssen Benutzer die s3:PutLifecycleConfiguration Erlaubnis erhalten.

Sie können Berechtigungen auch explizit verweigern. Die ausdrückliche Verweigerung hat auch Vorrang vor allen anderen Berechtigungen. Wenn Sie verhindern möchten, dass Benutzer oder Konten Objekte aus Ihrem Bucket entfernen oder löschen, müssen Sie ihnen die Berechtigungen für die folgenden Aktionen verweigern:

  • s3:DeleteObject

  • s3:DeleteObjectVersion

  • s3:PutLifecycleConfiguration

Weitere Informationen zu Berechtigungen finden Sie unter Verwalten von Zugriffsberechtigungen für Ihre Amazon S3-Ressourcen im Amazon Simple Storage Service-Benutzerhandbuch.

Anforderungen

Syntax

PUT /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Content-Length: length
Date: date
Authorization: authorization string 
Content-MD5: MD5

Lifecycle configuration in the request body

Einzelheiten zu Autorisierungszeichenfolgen finden Sie unterAnfragen authentifizieren (AWS Signatur (Version 4).

Anforderungsparameter

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

Anforderungsheader

Name Description Erforderlich
Content-MD5

Der Base64-kodierte 128-Bit-MD5-Digest der Daten. Sie müssen diesen Header zur Überprüfung der Nachrichtenintegrität verwenden, um sicherzustellen, dass der Anforderungstext bei der Übertragung nicht beschädigt wurde. Weitere Informationen finden Sie unter RFC 1864.

Typ: Zeichenfolge

Standard: keiner

 Ja

Anforderungstext

In der Anfrage geben Sie die Lifecycle-Konfiguration im Anforderungstext an. Die Lifecycle-Konfiguration ist als XML angegeben. Das Folgende ist ein Beispiel für eine grundlegende Lebenszykluskonfiguration. Sie spezifiziert eine Regel. Das Prefix in der Regel identifiziert Objekte, für die die Regel gilt. Die Regel spezifiziert auch zwei Aktionen (TransitionundExpiration). Jede Aktion gibt einen Zeitplan an, zu dem Amazon S3 die Aktion ausführen soll. Das Status gibt an, ob die Regel aktiviert oder deaktiviert ist.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <Transition>        
           <Date>value</Date>        
           <StorageClass>storage class</StorageClass>       
        </Transition>    
        <Expiration>
           <Days>value</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>

Wenn der Status Ihres Buckets die Versionierung aktiviert oder die Versionierung gesperrt ist, können Sie mehrere Versionen desselben Objekts haben: eine aktuelle Version und keine oder mehrere nicht aktuelle Versionen. Die folgende Lifecycle-Konfiguration spezifiziert die Aktionen (NoncurrentVersionTransition,NoncurrentVersionExpiration), die für nicht aktuelle Objektversionen spezifisch sind.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <NoncurrentVersionTransition>      
           <NoncurrentDays>value</NoncurrentDays>      
           <StorageClass>storage class</StorageClass>   
        </NoncurrentVersionTransition>    
        <NoncurrentVersionExpiration>     
           <NoncurrentDays>value</NoncurrentDays>    
        </NoncurrentVersionExpiration> 
    </Rule>
</LifecycleConfiguration>

Sie können die API für mehrteilige Uploads verwenden, um große Objekte in Teilen hochzuladen. Weitere Informationen zu mehrteiligen Uploads finden Sie unter Überblick über mehrteilige Uploads im Amazon Simple Storage Service-Benutzerhandbuch. Mit der Lebenszykluskonfiguration können Sie Amazon S3 anweisen, unvollständige mehrteilige Uploads, die durch das in der Regel angegebene Schlüsselnamenpräfix gekennzeichnet sind, zu stornieren, wenn sie nicht innerhalb einer bestimmten Anzahl von Tagen abgeschlossen werden. Wenn Amazon S3 einen mehrteiligen Upload storniert, werden alle mit dem Upload verknüpften Teile gelöscht. Dadurch wird sichergestellt, dass Sie keine unvollständigen mehrteiligen Uploads haben, bei denen noch Teile in Amazon S3 gespeichert sind, sodass Sie keine Lagerkosten dafür zahlen müssen. Das folgende Beispiel zeigt eine Lebenszykluskonfiguration, die eine Regel mit der Aktion AbortIncompleteMultipartUpload spezifiziert. Durch diese Aktion wird Amazon S3 angewiesen, unvollständige mehrteilige Uploads sieben Tage nach der Initiierung zu stornieren.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>SomeKeyPrefix/</Prefix>
        <Status>rule-status</Status>
        <AbortIncompleteMultipartUpload>
          <DaysAfterInitiation>7</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule>
</LifecycleConfiguration>

In der folgenden Tabelle werden die XML-Elemente in der Lifecycle-Konfiguration beschrieben.

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 dem ISO 8601-Format entsprechen. Die Uhrzeit ist stets Mitternacht UTC.

Typ: Zeichenfolge

Vorfahr: oder Expiration 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.

Typ: Nicht negative Ganzzahl bei Verwendung mitTransition, Positive Ganzzahl bei Verwendung mit Expiration

Vorfahr:, Expiration Transition

 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 ein übergeordnetes Tag angegeben ist
Expiration

Diese Aktion gibt einen Zeitraum in der Lebensdauer eines Objekts an, in dem Amazon S3 die entsprechende Ablaufaktion ergreifen sollte. Die Aktion, die Amazon S3 ergreift, hängt davon ab, ob der Bucket für 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.

  • Wenn für den Bucket die Versionierung aktiviert ist (oder die Versionierung unterbrochen ist), gilt die Aktion nur für die aktuelle Version des Objekts. Ein Bucket mit Versionskontrolle kann 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

    Verwenden Sie die Aktion, um das Ablaufdatum für nicht aktuelle Objekte festzulegen. NoncurrentVersionExpiration

Typ: Container

Kinder: Tage oder Datum

Vorfahr: Regel

 Ja, wenn keine andere Aktion in der Rule vorhanden 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 (einem Bucket mit Versionierung oder einem Bucket mit Versionssuspendierung) können Sie dieses Element zur Lebenszykluskonfiguration hinzufügen, um Amazon S3 anzuweisen, Markierungen zum Löschen abgelaufener Objekte zu löschen. Ein Beispiel finden Sie unter Beispiel 8: Entfernen von Markierungen zum Löschen abgelaufener Objekte im Amazon Simple Storage Service-Benutzerhandbuch. Fügen Sie es nicht zu einem Bucket ohne Versionierung hinzu, da dieser Bucket-Typ keine Löschmarkierungen enthalten kann.

Typ: Zeichenfolge

Gültige Werte: true | false (der Wert false ist zulässig, aber No-Op, was bedeutet, dass Amazon S3 keine Maßnahmen ergreift)

Vorfahr: Expiration

 Ja, wenn Date und Days sind abwesend
NoncurrentDays

Gibt die Anzahl der Tage an, die ein Objekt nicht-aktuell ist, bevor Amazon S3 die zugehörige Aktion ausführen kann. Informationen zu den Berechnungen nicht aktueller Tage finden Sie im Amazon Simple Storage Service-Benutzerhandbuch unter So berechnet Amazon S3, wenn ein Objekt nicht mehr aktuell ist.

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

Vorfahr: oder NoncurrentVersionExpiration NoncurrentVersionTransition

 Ja
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 anzuweisen, 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 SpeicherklasseSTANDARD_IA,ONEZONE_IA, oder übergehen.

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

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. Eine Lebenszykluskonfiguration kann bis zu 1000 Regeln enthalten.

Typ: Container

Ancestor:LifecycleConfiguration

 Ja
Status

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

Typ: Zeichenfolge

Ancestor: Regel

Gültige Werte: Aktiviert, Deaktiviert

 Ja
StorageClass

Gibt die Amazon S3-Speicherklasse an, in die das Objekt übergehen soll.

Typ: Zeichenfolge

Ancestor: Übergang und NoncurrentVersionTransition

Gültige Werte: STANDARD_IA | ONEZONE_IA | GLACIER

Ja

Dieses Element ist nur erforderlich, wenn Sie einen oder beide seiner Vorfahren angeben.
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 Versionskontrolle kann viele Versionen eines Objekts enthalten. Diese Aktion hat keine Auswirkung auf nicht aktuelle 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

Antworten

Antwort-Header

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

Antwortelemente

Diese Implementierung der Operation gibt keine Antwortelemente zurück.

Spezielle Fehler

Diese Implementierung der Operation gibt keine speziellen Fehler zurück. Allgemeine Informationen zu Amazon S3-Fehlern und eine Liste von Fehlercodes finden Sie unter Fehlerantworten.

Beispiele

Beispiel 1: Fügen Sie einem Bucket eine Lifecycle-Konfiguration hinzu, die es nicht ist Versioning-enabled

Die folgende Lebenszykluskonfiguration spezifiziert zwei Regeln mit jeweils einer Aktion.

  • Die Transition -Aktion weist Amazon S3 an, Objekte mit dem Präfix „documents/“ 30 Tage nach der Erstellung in die Speicherklasse zu übertragen.

  • Die Aktion „Ablauf“ weist Amazon S3 an, Objekte mit dem Präfix „logs/“ 365 Tage nach der Erstellung zu löschen.


<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Im Folgenden finden Sie eine PUT /?lifecycle Beispielanforderung, mit der die vorherige Lebenszykluskonfiguration zum Bucket hinzugefügt wirdexamplebucket.

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 415

<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Im Folgenden wird eine Beispielantwort dargestellt:

HTTP/1.1 200 OK
x-amz-id-2: r+qR7+nhXtJDDIJ0JJYcd+1j5nM/rUFiiiZ/fNbDOsd3JUE8NWMLNHXmvPfwMpdc
x-amz-request-id: 9E26D08072A8EF9E
Date: Wed, 14 May 2014 02:11:22 GMT
Content-Length: 0
Server: AmazonS3

Beispiel 2: Lifecycle-Konfiguration zu einem Versioning-enabled Bucket hinzufügen

Die folgende Lebenszykluskonfiguration spezifiziert zwei Regeln mit jeweils einer Aktion, die Amazon S3 ausführen muss. Sie geben diese Aktionen an, wenn Ihr Bucket für die Versionierung aktiviert ist oder die Versionierung unterbrochen ist:

  • Die NoncurrentVersionExpiration Aktion weist Amazon S3 an, nicht aktuelle Versionen von Objekten mit dem Präfix „logs/“ 100 Tage, nachdem die Objekte nicht mehr aktuell sind, ablaufen zu lassen.

  • Die NoncurrentVersionTransition Aktion weist Amazon S3 an, nicht aktuelle Versionen von Objekten mit dem Präfix „documents/“ 30 Tage, nachdem sie nicht mehr aktuell sind, auf die Speicherklasse umzustellen.

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>100</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>30</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

Im Folgenden finden Sie eine PUT /?lifecycle Beispielanforderung, mit der die vorherige Lifecycle-Konfiguration zum Bucket hinzugefügt wird. examplebucket

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:21:48 GMT
Content-MD5: 96rxH9mDqVNKkaZDddgnw==
Authorization: authorization string
Content-Length: 598

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>1</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionSoonAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>0</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

Im Folgenden wird eine Beispielantwort dargestellt:

HTTP/1.1 200 OK
x-amz-id-2: aXQ+KbIrmMmoO//3bMdDTw/CnjArwje+J49Hf+j44yRb/VmbIkgIO5A+PT98Cp/6k07hf+LD2mY=
x-amz-request-id: 02D7EC4C10381EB1
Date: Wed, 14 May 2014 02:21:50 GMT
Content-Length: 0
Server: AmazonS3

Weitere Beispiele

Weitere Beispiele für die Umstellung von Objekten auf Speicherklassen wie STANDARD_IA oder ONEZONE_IA finden Sie unter Beispiele für die Lifecycle-Konfiguration. https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-configuration-examples