View a markdown version of this page

Cycle de vie du bucket GET (obsolète) - Amazon Simple Storage Service
DescriptionRequêtesRéponsesErreurs spécialesExemplesRessources connexes

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)

Description

Important

Pour obtenir une version mise à jour de cette API, consultez GetBucketLifecycleConfiguration. 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 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Pour utiliser cette opération, vous devez être autorisé à effectuer l's3:GetLifecycleConfigurationaction. 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 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Requêtes

Syntaxe

GET /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Date: date
Authorization: authorization string (see Demandes d'authentification (AWS Signature (version 4))

Paramètres de demande

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

En-têtes de demande

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 courants.

Elements de la demande

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

Réponses

En-têtes de réponse

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 communs.

Éléments de réponse

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

Type : Conteneur

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 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

La valeur de date doit être conforme au format ISO 8601. L’heure indique toujours minuit UTC.

Type : Chaîne

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.

Type : Non-negative entier lorsqu'il est utilisé avecTransition, entier positif lorsqu'il est utilisé avecExpiration.

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.

Type : entier positif

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.

  • 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.

  • 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.

    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.

    Important

    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 versionnull, Amazon S3 remplace cette version.

    Note

    Pour définir l'expiration des objets non courants, vous devez utiliser cette NoncurrentVersionExpiration action.

Type : Conteneur

Enfants : jours ou date

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.

Type : Chaîne

Ancêtre : Rule

 Non
LifecycleConfiguration

Conteneur de règles de cycle de vie. Vous pouvez ajouter jusqu’à 1 000 règles.

Type : Conteneur

Enfants : règle

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 dans le Guide de l'utilisateur d'Amazon Simple Storage Service.

Type : Chaîne

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)

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 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Type : entier non négatif lorsqu'il est utilisé avecNoncurrentVersionTransition, entier positif lorsqu'il est utilisé avec NoncurrentVersionExpiration

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.

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.

Type : Conteneur

Enfants : NoncurrentDays

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_IAONEZONE_IA, ou à la classe de stockage.

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.

Type : Conteneur

Enfants : NoncurrentDays et StorageClass

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.

Type : Chaîne

Ancêtre : Rule

 Oui
Rule

Conteneur pour une règle de cycle de vie.

Type : Conteneur

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.

Type : Chaîne

Ancêtre : Rule

Valeurs valides : Activé ou Désactivé

 Oui
StorageClass

Spécifie la classe de stockage Amazon S3 vers laquelle vous souhaitez transférer l'objet.

Type : Chaîne

Ancêtre : Transition et NoncurrentVersionTransition

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_IAONEZONE_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.

  • 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.

  • 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.

    Note

    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.

Type : Conteneur

Enfants : jours ou date, et StorageClass

Ancêtre : Rule

 Oui, si aucune autre action n'est présente dans le Rule

Erreurs spéciales

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, consultezRéponses d'erreur.

Exemples

Exemple 1 : récupérer une sous-ressource du cycle de vie

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

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

Exemple de réponse

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>