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 PUT (obsolète)
Description
Important
Pour obtenir une version mise à jour de cette API, consultez PutBucketLifecycleConfiguration. Cette version est obsolète. Les configurations de cycle de vie existantes fonctionneront. Pour les nouvelles configurations de cycle de vie, utilisez l'API mise à jour.
Crée une nouvelle configuration de cycle de vie pour le compartiment ou remplace une configuration de cycle de vie existante. 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.
Permissions
Par défaut, toutes les ressources Amazon S3, y compris les compartiments, les objets et les sous-ressources associées (par exemple, la configuration du cycle de vie et la configuration du site Web) sont privées. Seul le propriétaire de la ressource, Compte AWS celui qui l'a créée, peut y accéder. Le propriétaire de la ressource peut éventuellement accorder des autorisations d'accès à d'autres personnes en rédigeant une politique d'accès. Pour cette opération, les utilisateurs doivent obtenir l's3:PutLifecycleConfigurationautorisation.
Vous pouvez également refuser explicitement les autorisations. Le refus explicite remplace également toute autre autorisation. Si vous souhaitez empêcher les utilisateurs ou les comptes de retirer ou de supprimer des objets de votre compartiment, vous devez leur refuser l'autorisation d'effectuer les actions suivantes :
s3:DeleteObjects3:DeleteObjectVersions3:PutLifecycleConfiguration
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
PUT /?lifecycle HTTP/1.1 Host:bucketname.s3.amazonaws.com Content-Length:lengthDate:dateAuthorization:authorization stringContent-MD5:MD5Lifecycle configuration in the request body
Pour plus de détails sur les chaînes d'autorisation, consultezDemandes 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
| Nom | Description | Obligatoire |
|---|---|---|
Content-MD5 |
Le condensé MD5 128 bits codé en base64 des données. Vous devez utiliser cet en-tête pour vérifier l'intégrité du message afin de vérifier que le corps de la demande n'a pas été endommagé pendant le transit. Pour plus d'informations, consultez la RFC 1864. Type : Chaîne Par défaut : aucun |
Oui |
Corps de la requête
Dans la demande, vous spécifiez la configuration du cycle de vie dans le corps de la demande. La configuration du cycle de vie est spécifiée au format XML. Voici un exemple de configuration de base du cycle de vie. Il spécifie une règle. Le Prefix contenu de la règle identifie les objets auxquels la règle s'applique. La règle spécifie également deux actions (TransitionetExpiration). Chaque action spécifie un calendrier dans lequel Amazon S3 doit effectuer l'action. StatusIndique si la règle est activée ou désactivée.
<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>
Si l'état de votre compartiment est activé ou suspendu, vous pouvez avoir plusieurs versions du même objet : une version actuelle et zéro ou plusieurs versions non actuelles. La configuration de cycle de vie suivante spécifie les actions (NoncurrentVersionTransition,NoncurrentVersionExpiration) spécifiques aux versions d'objets non actuelles.
<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>
Vous pouvez utiliser l'API de chargement partitionné pour charger des objets volumineux en plusieurs parties. Pour plus d'informations sur les chargements partitionnés, consultez la section Présentation des chargements partitionnés dans le guide de l'utilisateur d'Amazon Simple Storage Service. Avec la configuration du cycle de vie, vous pouvez demander à Amazon S3 d'annuler les chargements partitionnés incomplets, qui sont identifiés par le préfixe du nom de clé spécifié dans la règle, s'ils ne sont pas terminés dans un délai de jours spécifié. Lorsqu'Amazon S3 annule un chargement en plusieurs parties, il supprime toutes les parties associées au téléchargement. Cela vous permet d'éviter les chargements partitionnés incomplets dont certaines parties ont été stockées dans Amazon S3. Vous n'avez donc pas à payer de frais de stockage pour ces téléchargements. Voici un exemple de configuration du cycle de vie qui spécifie une règle avec l’action AbortIncompleteMultipartUpload. Cette action indique à Amazon S3 d'annuler les chargements partitionnés incomplets sept jours après leur lancement.
<LifecycleConfiguration> <Rule> <ID>sample-rule</ID> <Prefix>SomeKeyPrefix/</Prefix> <Status>rule-status</Status> <AbortIncompleteMultipartUpload> <DaysAfterInitiation>7</DaysAfterInitiation> </AbortIncompleteMultipartUpload> </Rule> </LifecycleConfiguration>
Le tableau suivant décrit les éléments XML de la configuration du cycle de vie.
| 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 : Type : Conteneur Ancêtre : |
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 : |
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. Type : entier non négatif lorsqu'il est utilisé avec Ancêtre : |
Oui, si Date et si vous ExpiredObjectDeleteMarker êtes absents |
DaysAfterInitiation
|
Spécifie le nombre de jours qui suivent 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 : |
Oui, si un tag parent est spécifié |
Expiration
|
Cette action spécifie une période de la durée de vie d'un objet pendant laquelle Amazon S3 doit prendre l'action d'expiration appropriée. L'action entreprise par Amazon S3 varie selon que le bucket est activé ou non pour la gestion des versions.
Type : Conteneur Enfants : jours ou date Ancêtre : Rule |
Oui, si aucune autre action n'est présente dans leRule. |
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é (un compartiment activé ou suspendu pour la gestion des versions), vous pouvez ajouter cet élément dans la configuration du cycle de vie pour indiquer à Amazon S3 de supprimer les marqueurs de suppression d'objets expirés. Pour un exemple, consultez l'Exemple 8 : Suppression des marqueurs de suppression d'objets expirés dans le guide de l'utilisateur d'Amazon Simple Storage Service. Ne l'ajoutez pas à un compartiment non versionné, car ce type de compartiment ne peut pas inclure de marqueurs de suppression. Type : Chaîne Valeurs valides : true | false (la valeur Ancêtre : |
Oui, si Date et si vous Days êtes absents |
NoncurrentDays |
Spécifie le nombre de jours depuis lequel un objet est ancien avant qu'Amazon S3 puisse effectuer l'action associée. Pour plus d'informations sur les calculs des jours non courants, consultez Comment Amazon S3 calcule quand un objet est devenu non courant dans le guide de l'utilisateur d'Amazon Simple Storage Service. Type : entier non négatif lorsqu'il est utilisé avec Ancêtre : |
Oui |
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 indiquer à 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 Si la gestion des versions est activée dans votre compartiment (ou si la gestion des versions est suspendue), vous pouvez définir cette action pour indiquer à Amazon S3 de transférer 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 et StorageClass Ancêtre : Rule |
Oui, si aucune autre action n'est présente dans le Rule |
Prefix
|
Préfixe de clé d'objet qui identifie 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. Une configuration de cycle de vie peut contenir jusqu'à 1 000 règles. Type : Conteneur Ancestor:LifecycleConfiguration |
Oui |
Status
|
Si cette option est activée, Amazon S3 exécute la règle comme prévu. S'il est désactivé, Amazon S3 ignore la règle. Type : Chaîne Ancêtre : Rule Valeurs valides : Activé, Désactivé |
Oui |
StorageClass
|
Spécifie la classe de stockage Amazon S3 vers laquelle vous souhaitez que l'objet fasse la transition. Type : Chaîne Ancêtre : Transition et NoncurrentVersionTransition Valeurs valides : STANDARD_IA | ONEZONE_IA | GLACIER |
Oui Cet élément n'est obligatoire que si vous spécifiez l'un de ses ancêtres ou les deux. |
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
Type : Conteneur Enfants : jours ou date, et StorageClass Ancêtre : Rule |
Oui, si aucune autre action n'est présente dans le Rule |
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 l'opération ne renvoie pas d'éléments de réponse.
Erreurs spéciales
Cette implémentation de l'opération ne renvoie pas d'erreurs spéciales. Pour obtenir des informations générales sur les erreurs Amazon S3 et une liste des codes d'erreur, consultez la section Réponses aux erreurs.
Exemples
Exemple 1 : ajouter une configuration de cycle de vie à un compartiment qui ne l'est pas Versioning-enabled
La configuration de cycle de vie suivante spécifie deux règles, chacune comportant une action.
-
L'action Transition indique à Amazon S3 de transférer les objets dotés du préfixe « documents/ » vers la classe de stockage 30 jours après leur création.
-
L'action Expiration indique à Amazon S3 de supprimer les objets dotés du préfixe « logs/ » 365 jours après leur création.
<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>
Voici un exemple de PUT /?lifecycle demande qui ajoute la configuration de cycle de vie précédente au examplebucket compartiment.
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 stringContent-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>
Voici un exemple de réponse.
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
Exemple 2 : ajouter une configuration de cycle de vie à un Versioning-enabled bucket
La configuration de cycle de vie suivante spécifie deux règles, chacune comportant une action à effectuer par Amazon S3. Vous spécifiez les actions suivantes lorsque la gestion des versions est activée ou que la gestion des versions est suspendue :
-
L'
NoncurrentVersionExpirationaction indique à Amazon S3 d'expirer les versions non actuelles des objets avec le préfixe « logs/ » 100 jours après que les objets soient devenus obsolètes. -
L'
NoncurrentVersionTransitionaction indique à Amazon S3 de transférer les versions non actuelles des objets avec le préfixe « documents/ » vers la classe de stockage 30 jours après leur mise à jour.
<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>
Voici un exemple de PUT /?lifecycle demande qui ajoute la configuration de cycle de vie précédente au examplebucket compartiment.
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 stringContent-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>
Voici un exemple de réponse.
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
Exemples supplémentaires
Pour plus d'exemples de transition d'objets vers des classes de stockage telles que STANDARD_IA ou ONEZONE_IA, consultez la section Exemples de configuration du cycle de vie. https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-configuration-examples
Ressources connexes
-
Par défaut, le propriétaire d'une ressource, dans ce cas, le propriétaire du compartiment, qui est Compte AWS celui qui a créé le compartiment, peut effectuer n'importe laquelle des opérations. Le propriétaire d'une ressource peut également autoriser d'autres personnes à effectuer l'opération. Pour en savoir plus, consulter les rubriques suivantes dans le Guide de l'utilisateur d'Amazon Simple Storage Service :
