Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Cycle de vie du bucket GET (obsolète)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

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



 

**Important**  
Pour obtenir une version mise à jour de cette API, consultez [ GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html). Si vous avez configuré le cycle de vie d'un bucket à l'aide de <filter>cet élément, vous devriez voir une version mise à jour de cette rubrique. Cette rubrique est fournie à des fins de rétrocompatibilité. 

Renvoie les informations `lifecycle` de configuration définies sur le bucket. Pour plus d'informations sur la configuration du cycle de vie, consultez la [ section Gestion du cycle de vie des objets ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*. 

Pour utiliser cette opération, vous devez être autorisé à effectuer l'`s3:GetLifecycleConfiguration`action. Le propriétaire du bucket dispose de cette autorisation par défaut. Le propriétaire du bucket peut accorder cette autorisation à d'autres personnes. Pour plus d'informations sur les autorisations, consultez [ la section Gestion des autorisations d'accès à vos ressources Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*.

## Requêtes
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### Syntaxe
<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 Demandes d'authentification (AWS Signature (version 4))
```

### Paramètres de demande
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

Cette implémentation de l'opération n'utilise pas de paramètres de demande.

### En-têtes de demande
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

Cette implémentation de l'opération utilise uniquement des en-têtes de requête communs à toutes les opérations. Pour plus d'informations, consultez la section En-têtes [ de requête ](RESTCommonRequestHeaders.md) courants.

### Elements de la demande
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

Cette implémentation de l'opération n'utilise pas d'éléments de requête.

## Réponses
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### En-têtes de réponse
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

Cette implémentation de l'opération utilise uniquement les en-têtes de réponse communs à la plupart des réponses. Pour plus d'informations, consultez la section En-têtes [ de réponse ](RESTCommonResponseHeaders.md) communs.

### Éléments de réponse
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

Cette implémentation de `GET` renvoie les éléments de réponse suivants.


|  Nom  |  Description  | Obligatoire | 
| --- | --- | --- | 
|  AbortIncompleteMultipartUpload  | Conteneur permettant de spécifier à quel moment un téléchargement partitionné incomplet peut faire l'objet d'une opération d'abandon.Enfant : `DaysAfterInitiation`<br />Type : Conteneur<br />Ancêtre : `Rule` | Oui, si aucune autre action n'est spécifiée pour la règle | 
|  Date  | Date à laquelle vous souhaitez qu'Amazon S3 entreprenne l'action. Pour plus d'informations, consultez Règles de [ cycle de vie : basées sur une date spécifique ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*.<br />La valeur de date doit être conforme au format ISO 8601. L’heure indique toujours minuit UTC. <br />Type : Chaîne<br />Ancêtre : `Expiration` ou `Transition` | Oui, si Days et si vous ExpiredObjectDeleteMarker êtes absents | 
|  Days  | Spécifie le nombre de jours après la création de l'objet pendant lesquels l'action de règle spécifique prend effet. La durée d'éligibilité de l'objet est calculée comme l'heure de création \+ le nombre de jours, le temps obtenu étant arrondi à minuit UTC le jour suivant.<br />Type : Non-negative entier lorsqu'il est utilisé avec`Transition`, entier positif lorsqu'il est utilisé avec`Expiration`.<br />Ancêtre : `Transition` ou `Expiration` | Oui, si Date et si vous ExpiredObjectDeleteMarker êtes absents | 
|  DaysAfterInitiation  | Spécifie le nombre de jours après le lancement d'un chargement en plusieurs parties pendant lesquels le téléchargement en plusieurs parties doit être terminé. S'il ne se termine pas dans le délai spécifié, il devient éligible à une opération d'abandon et Amazon S3 annule le chargement partitionné incomplet.<br />Type : entier positif<br />Ancêtre : `AbortIncompleteMultipartUpload` | Oui, en cas Date d'absence | 
|  Expiration  | Cette action spécifie une période de la durée de vie de l'objet pendant laquelle Amazon S3 doit prendre l'action d'expiration appropriée. L'action d'expiration se produit uniquement sur les objets éligibles selon la période spécifiée dans l'enfant `Date` ou l'`Days`élément. L'action qu'Amazon S3 entreprend dépend de l'activation ou non de la gestion des versions du bucket. <br /> +  Si la gestion des versions n'a jamais été activée sur le compartiment, Amazon S3 supprime définitivement la seule copie de l'objet.  <br />+  Sinon, si la gestion des versions est activée dans votre compartiment (ou si la gestion des versions est suspendue), l'action s'applique uniquement à la version actuelle de l'objet. Les compartiments dont la gestion des versions est activée ou suspendue peuvent contenir plusieurs versions du même objet : une version actuelle et zéro ou plusieurs versions non actuelles. <br />Au lieu de supprimer la version actuelle, Amazon S3 en fait une version non actuelle en ajoutant un marqueur de suppression comme nouvelle version actuelle.  <br />  Si l'état d'un compartiment est suspendu pour cause de version, Amazon S3 crée un marqueur de suppression avec l'ID de version. `null` Si vous possédez une version avec un ID de version`null`, Amazon S3 remplace cette version.   <br />  Pour définir l'expiration des objets non courants, vous devez utiliser cette `NoncurrentVersionExpiration` action.  <br />Type : Conteneur<br />Enfants : jours ou date<br />Ancêtre : Rule | Oui, si la balise parent est spécifiée | 
|  ID  | Identifiant unique de la règle. La valeur ne peut pas dépasser 255 caractères.<br />Type : Chaîne<br />Ancêtre : Rule | Non | 
| LifecycleConfiguration  | Conteneur de règles de cycle de vie. Vous pouvez ajouter jusqu’à 1 000 règles.<br />Type : Conteneur<br />Enfants : règle<br />Ancêtre : Aucun | Oui | 
| ExpiredObjectDeleteMarker | Dans un compartiment versionné (compartiment dont la version est activée ou dont la version est suspendue), cet élément indique si Amazon S3 supprimera les marqueurs de suppression d'objets expirés dans le compartiment. Pour un exemple, consultez l'[Exemple 8 : Spécifier une action d'expiration pour supprimer les marqueurs de suppression d'objets expirés ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8) dans le Guide de l'utilisateur d'*Amazon Simple Storage Service*.<br />Type : Chaîne <br />Valeurs valides : true \| false (la valeur false est autorisée mais elle n'est pas opérationnelle, Amazon S3 n'agit pas si la valeur est fausse)<br />Ancêtre : `Expiration` | Oui, si Date et si vous Days êtes absents | 
| NoncurrentDays  | Spécifie le nombre de jours pendant lesquels un objet n'est pas à jour avant qu'Amazon S3 puisse effectuer l'action associée. Pour plus d'informations sur le calcul des jours non courants, consultez la section Règles de [ cycle de vie basées sur le nombre de jours ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.<br />Type : entier non négatif lorsqu'il est utilisé avec`NoncurrentVersionTransition`, entier positif lorsqu'il est utilisé avec `NoncurrentVersionExpiration`<br />Ancêtre : `NoncurrentVersionExpiration` ou `NoncurrentVersionTransition` | Oui, uniquement si l'ancêtre est présent | 
| NoncurrentVersionExpiration  | Spécifie quand les versions d'objet anciennes expirent. Lorsqu'elles expirent, Amazon S3 supprime définitivement les versions d'objet anciennes. <br />Définissez cette action de configuration du cycle de vie sur un compartiment dont la gestion des versions est activée (ou suspendue) pour demander à Amazon S3 de supprimer les versions non actuelles de l'objet à une période spécifique de la durée de vie de l'objet.<br />Type : Conteneur<br />Enfants : NoncurrentDays <br />Ancêtre : Rule | Oui, si aucune autre action n'est présente dans le Rule | 
| NoncurrentVersionTransition | Conteneur pour la règle de transition qui décrit le moment où des objets non courants passent à la classe de stockage `STANDARD_IA``ONEZONE_IA`, ou à la classe de stockage. <br />Si la gestion des versions est activée dans votre compartiment (ou si la gestion des versions est suspendue), vous pouvez configurer cette action pour demander à Amazon S3 de transférer les versions non actuelles de l'objet vers la classe de stockage à une période spécifique de la durée de vie de l'objet.<br />Type : Conteneur<br />Enfants : NoncurrentDays et StorageClass<br />Ancêtre : Rule | Oui, si aucune autre action n'est présente dans le Rule | 
|  Prefix  | Préfixe de clé d'objet identifiant un ou plusieurs objets auxquels la règle s'applique.<br />Type : Chaîne<br />Ancêtre : Rule | Oui | 
| Rule  | Conteneur pour une règle de cycle de vie.<br />Type : Conteneur<br />Ancêtre : LifecycleConfiguration | Oui | 
|  Status  | Si cette option est activée, Amazon S3 exécute la règle comme prévu. Si cette option est désactivée, Amazon S3 ignore la règle.<br />Type : Chaîne<br />Ancêtre : Rule<br />Valeurs valides : Activé ou Désactivé | Oui | 
|  StorageClass  | Spécifie la classe de stockage Amazon S3 vers laquelle vous souhaitez transférer l'objet.<br />Type : Chaîne<br />Ancêtre : Transition et NoncurrentVersionTransition<br />Valeurs valides : `STANDARD_IA` \| `ONEZONE_IA` \|  | Oui | 
|  Transition  | Cette action spécifie une période de la durée de vie des objets au cours de laquelle Amazon S3 doit les faire passer à la classe de stockage `STANDARD_IA``ONEZONE_IA`, ou à la classe de stockage. Lorsque cette action est effective, les actions d'Amazon S3 dépendent du fait que le compartiment est activé ou non pour la gestion des versions.<br /> +  Si la gestion des versions n'a jamais été activée sur le compartiment, Amazon S3 transfère la seule copie de l'objet vers la classe de stockage spécifiée.  <br />+  Lorsque la gestion des versions de votre compartiment est activée (ou que la gestion des versions est suspendue), Amazon S3 transfère uniquement les versions actuelles des objets identifiés dans la règle. <br />  Un bucket dont la gestion des versions est activée ou suspendue peut contenir de nombreuses versions d'un objet. Cette action n'a aucun effet sur les versions non actuelles des objets. Pour effectuer la transition d'objets non courants, vous devez utiliser cette `NoncurrentVersionTransition` action.  <br />Type : Conteneur<br />Enfants : jours ou date, et StorageClass<br />Ancêtre : Rule | Oui, si aucune autre action n'est présente dans le Rule | 

## Erreurs spéciales
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| Code d’erreur | Description | HTTP Status Code | Préfixe du code d'erreur SOAP | 
| --- | --- | --- | --- | 
| NoSuchLifecycleConfiguration | La configuration du cycle de vie n'existe pas.  | 404 – Non trouvé | Client | 

Pour obtenir des informations générales sur les erreurs Amazon S3 et une liste des codes d'erreur, consultez[Réponses d'erreur](ErrorResponses.md).

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

### Exemple 1 : récupérer une sous-ressource du cycle de vie
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

Cet exemple est une requête GET pour récupérer la `lifecycle` sous-ressource du compartiment spécifié, et un exemple de réponse avec la configuration du cycle de vie renvoyée. 

#### Exemple de demande
<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}}
```

#### Exemple de réponse
<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>
```

## Ressources connexes
<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)