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)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## Description
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**Wichtig**  
Eine aktualisierte Version dieser API finden Sie unter [ GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html). 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*](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) im * Amazon Simple Storage Service-Benutzerhandbuch*.

## Anforderungen
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### Syntax
<a name="v1-rel-RESTBucketGETlifecycle-requests-syntax"></a>

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

### Anforderungsparameter
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

### Anforderungsheader
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

Diese Implementierung des Vorgangs verwendet nur Anforderungsheader, die allen Vorgängen gemeinsam sind. Weitere Informationen finden Sie unter [ Allgemeine ](RESTCommonRequestHeaders.md) Anforderungsheader.

### Anfrage-Elemente
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

Diese Implementierung des Vorgangs verwendet keine Anforderungselemente.

## Antworten
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### Antwort-Header
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

Diese Implementierung des Vorgangs verwendet nur Antwortheader, die den meisten Antworten gemeinsam sind. Weitere Informationen finden Sie unter [ Allgemeine ](RESTCommonResponseHeaders.md) Antwortheader.

### Antwortelemente
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

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`<br />Typ: Container<br />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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date) im * Amazon Simple Storage Service-Benutzerhandbuch*.<br />Der Datumswert muss konform zum Format ISO 8601 angegeben werden. Die Uhrzeit ist stets Mitternacht UTC. <br />Typ: Zeichenfolge<br />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.<br />Typ: Non-negative Ganzzahl bei Verwendung mit`Transition`, positive Ganzzahl bei Verwendung mit`Expiration`.<br />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.<br />Typ: Positive Ganzzahl<br />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. <br /> +  Wenn die Versionierung für den Bucket noch nie aktiviert wurde, löscht Amazon S3 die einzige Kopie des Objekts dauerhaft.  <br />+  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. <br />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.  <br />  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 haben`null`, überschreibt Amazon S3 diese Version.   <br />  Um das Ablaufdatum für nicht aktuelle Objekte festzulegen, müssen Sie die `NoncurrentVersionExpiration` Aktion verwenden.  <br />Typ: Container<br />Kinder: Tage oder Datum<br />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.<br />Typ: Zeichenfolge<br />Vorfahr: Regel | Nein | 
| LifecycleConfiguration  | Container für Lebenszyklusregeln. Sie können bis zu 1000 Regeln hinzufügen.<br />Typ: Container<br />Kinder: Regel<br />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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8) zum Löschen abgelaufener Objekte zu entfernen. *<br />Typ: Zeichenfolge <br />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)<br />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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days) im * Amazon Simple Storage Service-Benutzerhandbuch. *<br />Typ: Nicht negative Ganzzahl bei Verwendung in Kombination`NoncurrentVersionTransition`, positive Ganzzahl bei Verwendung mit `NoncurrentVersionExpiration`<br />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. <br />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.<br />Typ: Container<br />Kinder: NoncurrentDays <br />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_IA``ONEZONE_IA`, oder die Speicherklasse übergehen. <br />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.<br />Typ: Container<br />Kinder: und NoncurrentDays StorageClass<br />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.<br />Typ: Zeichenfolge<br />Vorfahr: Regel | Ja | 
| Rule  | Container für eine Lebenszyklusregel.<br />Typ: Container<br />Vorfahr: LifecycleConfiguration | Ja | 
|  Status  | Wenn aktiviert, führt Amazon S3 die Regel wie geplant aus. Wenn deaktiviert, ignoriert Amazon S3 die Regel.<br />Typ: Zeichenfolge<br />Ancestor: Regel<br />Gültige Werte: Aktiviert oder Deaktiviert | Ja | 
|  StorageClass  | Gibt die Amazon S3-Speicherklasse an, zu der Sie das Objekt übertragen möchten.<br />Typ: Zeichenfolge<br />Ancestor: Übergang und NoncurrentVersionTransition<br />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 Speicherklasse`STANDARD_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.<br /> +  Wenn die Versionierung für den Bucket noch nie aktiviert wurde, überträgt Amazon S3 die einzige Kopie des Objekts in die angegebene Speicherklasse.  <br />+  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. <br />  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.  <br />Typ: Container<br />Kinder: Tage oder Datum und StorageClass<br />Vorfahr: Regel | Ja, wenn keine andere Aktion in der Rule | 

## Spezielle Fehler
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| 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 unter[Fehlermeldungen](ErrorResponses.md).

## Beispiele
<a name="v1-rel-RESTBucketGETlifecycle-examples"></a>

### Beispiel 1: Rufen Sie eine Lifecycle-Unterressource ab
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

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

#### Beispielanforderung
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-request"></a>

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

#### Beispielantwort
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
 3. x-amz-request-id: 51991C342C575321
 4. Date: Thu, 15 Nov 2012 00:17:23 GMT
 5. Server: AmazonS3
 6. Content-Length: 358
 7. 
 8. <?xml version="1.0" encoding="UTF-8"?>
 9. <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
10.     <Rule>
11.         <ID>Archive and then delete rule</ID>
12.         <Prefix>projectdocs/</Prefix>
13.         <Status>Enabled</Status>
14.        <Transition>
15.            <Days>30</Days>
16.            <StorageClass>STANDARD_IA</StorageClass>
17.         </Transition>
18.         <Transition>
19.            <Days>365</Days>
20.            <StorageClass>GLACIER</StorageClass>
21.         </Transition>
22.         <Expiration>
23.            <Days>3650</Days>
24.         </Expiration>
25.     </Rule>
26. </LifecycleConfiguration>
```

## Verwandte Ressourcen
<a name="v1-rel-RESTBucketGETlifecycle-related-resources"></a>
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)