Appelez l'opération PutBucketLifecycle pour configurer une règle de cycle de vie - Object Storage Service

Créez des règles de cycle de vie basées sur la date de dernière modification ou le dernier accès. Ces règles convertissent périodiquement la classe de stockage des objets d'un bucket ou suppriment les objets et parties expirés afin de réduire les coûts de stockage. Cette rubrique explique comment appeler l'opération PutBucketLifecycle pour configurer une règle de cycle de vie pour un bucket.

Notes

L'opération PutBucketLifecycle écrase les règles de cycle de vie existantes. Par exemple, si un bucket possède une règle de cycle de vie nommée Rule1 et que vous souhaitez ajouter une règle nommée Rule2, suivez les étapes suivantes :
1. Appelez l'opération GetBucketLifecycle pour récupérer la configuration de Rule1.
2. Ajoutez Rule2 à la configuration existante.
3. Appelez l'opération PutBucketLifecycle pour appliquer la nouvelle configuration incluant à la fois Rule1 et Rule2.

Définissez une durée d'expiration pour les objets et les parties. Les parties correspondent aux fragments non validés issus des téléchargements multiparties.
Les règles peuvent correspondre aux objets en fonction de leur dernier accès ou de leur dernière modification.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des politiques RAM ou une Bucket Policy.

API

Action

Description

PutBucketLifecycle

oss:PutBucketLifecycle

Configure les règles de cycle de vie pour un bucket.

Syntaxe de la requête

PUT /?lifecycle HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue 
Host: BucketName.oss.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>RuleID</ID>
    <Prefix>Prefix</Prefix>
    <Status>Status</Status>
    <Expiration>
      <Days>Days</Days>
    </Expiration>
    <Transition>
      <Days>Days</Days>
      <StorageClass>StorageClass</StorageClass>
    </Transition>
    <AbortMultipartUpload>
      <Days>Days</Days>
    </AbortMultipartUpload>
  </Rule>
</LifecycleConfiguration>

En-têtes de requête

Nom

Type

Obligatoire

Exemple

Description

x-oss-allow-same-action-overlap

string

Non

true

Indique si les règles de cycle de vie peuvent avoir des préfixes qui se chevauchent. Valeurs possibles :

true : Les préfixes qui se chevauchent sont autorisés.
false : Les préfixes qui se chevauchent ne sont pas autorisés.

Cette opération utilise des en-têtes de requête courants, tels que Date et Authorization. Pour plus d'informations, consultez la section En-têtes de requête courants.

Éléments de la requête

Nom	Type	Obligatoire	Exemple	Description
LifecycleConfiguration	container	Oui	N/A	Conteneur pour les configurations de cycle de vie. Vous pouvez configurer jusqu'à 1 000 règles. Nœud enfant : Rule Nœud parent : Aucun
Rule	container	Oui	N/A	Conteneur pour une règle de cycle de vie. La date d'expiration d'un objet doit être postérieure à la date de conversion de l'objet vers la classe de stockage Infrequent Access (IA) ou Archive Storage. Nœuds enfants : ID, Prefix, Status et Expiration Nœud parent : LifecycleConfiguration
ID	string	Non	rule1	Identifiant unique de la règle. L'ID peut comporter jusqu'à 255 caractères. Si vous ne spécifiez pas cet élément ou si vous le laissez vide, OSS génère automatiquement un ID unique. Nœud enfant : Aucun Nœud parent : Rule
Prefix	string	Non	tmp/	Préfixe spécifiant les objets auxquels la règle s'applique. Vous ne pouvez pas définir le même préfixe pour différentes règles. Si vous spécifiez Prefix, la règle s'applique uniquement aux objets du bucket possédant le préfixe indiqué. Si vous laissez Prefix vide, la règle s'applique à tous les objets du bucket. Nœud enfant : Aucun Nœud parent : Rule
Status	string	Oui	Enabled	Indique si la règle est activée. Valeurs possibles : Enabled : La règle est activée. OSS exécute la règle périodiquement. Disabled : La règle est désactivée. OSS ignore la règle. Nœud parent : Rule
Expiration	container	Non	N/A	Spécifie les propriétés d'expiration d'un objet. Pour un bucket avec versioning activé, la date d'expiration spécifiée s'applique uniquement à la version actuelle d'un objet. La date d'expiration d'un objet doit être postérieure à la date de conversion de l'objet vers la classe de stockage IA ou Archive Storage. Nœuds enfants : Days, CreatedBeforeDate ou ExpiredObjectDeleteMarker Nœud parent : Rule
Days	Entier positif	Days et CreatedBeforeDate s'excluent mutuellement	1	Spécifie le nombre de jours après la dernière mise à jour d'un objet avant que la règle de cycle de vie ne prenne effet. Si le paramètre IsAccessTime est défini sur true dans la requête, ce paramètre spécifie le nombre de jours après le dernier accès à un objet avant que la règle de cycle de vie ne prenne effet. Nœuds parents : Expiration ou AbortMultipartUpload
CreatedBeforeDate	string	CreatedBeforeDate et Days s'excluent mutuellement	2002-10-11T00:00:00.000Z	Spécifie une date. OSS applique la règle de cycle de vie aux données dont la dernière mise à jour est antérieure à cette date. La date doit être au format yyyy-MM-ddT00:00:00.000Z. La date doit être exprimée en UTC et conforme à la norme ISO 8601. L'heure doit être 00:00:00. Nœuds parents : Expiration ou AbortMultipartUpload
ExpiredObjectDeleteMarker	string	Non	true	Indique s'il faut supprimer automatiquement les marqueurs de suppression expirés. Valeurs possibles : true : Supprime automatiquement les marqueurs de suppression expirés. Si vous définissez cette valeur sur true, vous ne pouvez pas spécifier Days ni CreatedBeforeDate. false : Ne supprime pas automatiquement les marqueurs de suppression expirés. Si vous définissez cette valeur sur false, vous devez spécifier Days ou CreatedBeforeDate. Nœud parent : Expiration
Transition	container	Non	N/A	Spécifie quand OSS convertit la classe de stockage d'un objet pendant son cycle de vie valide. Vous pouvez convertir les objets Standard d'un bucket Standard vers la classe de stockage IA, Archive ou Cold Archive. Toutefois, la date de conversion vers Archive doit être postérieure à celle de la conversion vers IA. Par exemple, si vous définissez Days sur 30 pour la transition vers IA, vous devez définir Days sur une valeur supérieure à 30 pour la transition vers Archive. Nœud parent : Rule Nœuds enfants : Days, CreatedBeforeDate et StorageClass Important Important Vous pouvez spécifier soit Days, soit CreatedBeforeDate.
StorageClass	string	Obligatoire si le nœud parent est Transition ou NoncurrentVersionTransition	IA	Spécifie la classe de stockage vers laquelle un objet est converti. Valeurs possibles : IA : Infrequent Access Archive : Archive Storage ColdArchive : Cold Archive DeepColdArchive : Deep Cold Archive Important Vous pouvez convertir la classe de stockage des objets d'un bucket IA vers Archive Storage ou Cold Archive, mais pas vers Standard. Nœud parent : Transition
AbortMultipartUpload	container	Non	N/A	Spécifie les propriétés d'expiration des parties non validées lors d'un téléchargement multipartie. Nœuds enfants : Days ou CreatedBeforeDate Nœud parent : Rule
Tag	container	Non	N/A	Tags d'objet auxquels la règle s'applique. Vous pouvez spécifier plusieurs tags. Nœud parent : Rule Nœuds enfants : Key et Value
Key	string	Obligatoire si le nœud parent est Tag	TagKey1	Clé du tag d'objet. Nœud parent : Tag
Value	string	Obligatoire si le nœud parent est Tag	TagValue1	Valeur du tag d'objet. Nœud parent : Tag
NoncurrentVersionExpiration	container	Non	N/A	Spécifie les propriétés d'expiration des versions précédentes des objets. Nœud enfant : NoncurrentDays
NoncurrentVersionTransition	container	Non	N/A	Spécifie quand OSS convertit la classe de stockage des versions précédentes d'un objet vers IA ou Archive Storage. La date de conversion d'un objet Standard vers Archive doit être postérieure à celle de la conversion vers IA. Nœuds enfants : NoncurrentDays et StorageClass
NoncurrentDays	string	Obligatoire si le nœud parent est NoncurrentVersionExpiration ou NoncurrentVersionTransition	10	Spécifie le nombre de jours après qu'un objet est devenu une version précédente avant que la règle de cycle de vie ne prenne effet. Si le paramètre IsAccessTime est défini sur true dans la requête, ce paramètre spécifie le nombre de jours après le dernier accès à un objet avant que la règle de cycle de vie ne prenne effet. Nœuds parents : NoncurrentVersionTransition et NoncurrentVersionExpiration
IsAccessTime	string	Non	true	Indique si la règle doit correspondre en fonction du dernier accès. Valeurs possibles : true : Correspondance basée sur le dernier accès à un objet. false (par défaut) : Correspondance basée sur la dernière modification d'un objet. Nœuds parents : Transition ou NoncurrentVersionTransition.
ReturnToStdWhenVisit	string	Non	false	Indique s'il faut convertir la classe de stockage d'un objet non Standard vers Standard lorsque l'objet est à nouveau consulté. Ce paramètre n'est valide que si IsAccessTime est défini sur true. Valeurs possibles : true : La classe de stockage de l'objet est convertie vers Standard. false (par défaut) : La classe de stockage de l'objet reste non Standard. Nœuds parents : Transition ou NoncurrentVersionTransition.
AllowSmallFile	string	Non	false	Lorsque vous définissez une règle de cycle de vie basée sur le dernier accès, ce paramètre indique s'il faut convertir les objets de moins de 64 Ko vers la classe de stockage IA, Archive ou Cold Archive. Valeurs possibles : true (par défaut) : Convertit tous les objets, y compris ceux de moins de 64 Ko. Les objets de moins de 64 Ko sont facturés comme s'ils faisaient 64 Ko. Les objets de 64 Ko ou plus sont facturés selon leur taille réelle. Définir ce paramètre sur true peut augmenter vos frais de stockage. false : Ne convertit pas les objets de moins de 64 Ko. Nœuds parents : Transition ou NoncurrentVersionTransition.
Filter	container	Non	N/A	Conteneur pour les paramètres de condition de cette règle d'exclusion. Vous pouvez spécifier au maximum un conteneur ou le laisser vide. Nœud parent : Rule Nœud enfant : Not
Not	container	Non	N/A	Si un objet répond à cette condition, la règle est ignorée. Si vous configurez Filter, vous devez spécifier un et un seul nœud Not sous Filter. Nœud parent : Filter Nœuds enfants : Prefix et Tag
Prefix	string	Oui	tmp/not/	Préfixe d'objet auquel cette règle d'exclusion s'applique. Ce paramètre ne peut pas être vide. Si vous configurez Prefix dans le nœud Rule, le Prefix dans le nœud Not doit commencer par le Prefix du nœud Rule. Par exemple, si le Prefix dans le nœud Rule est `dir`, le Prefix dans le nœud Not doit commencer par `dir`, comme `dir1` ou `dir2`. Si vous ne configurez pas Tag dans le nœud Not, le Prefix dans le nœud Not ne peut pas être identique au Prefix dans le nœud Rule. Nœud parent : Not Nœud enfant : Aucun
Tag	container	Non	N/A	Tag d'objet auquel cette règle d'exclusion s'applique. Vous pouvez spécifier au maximum un tag ou laisser ce paramètre vide.
ObjectSizeGreaterThan	Entier positif	Non	500	Taille minimale d'objet à laquelle cette règle s'applique. Ce paramètre est facultatif et vous ne pouvez en spécifier qu'un seul. Si vous définissez également ObjectSizeLessThan, le système vérifie la relation de taille entre les deux. Ce paramètre s'exclut mutuellement avec AllowSmallFile. Nœud parent : Filter Nœud enfant : Aucun
ObjectSizeLessThan	Entier positif	Non	64000	Taille maximale d'objet à laquelle cette règle s'applique. Ce paramètre est facultatif et vous ne pouvez en spécifier qu'un seul. Si vous définissez également ObjectSizeGreaterThan, le système vérifie la relation de taille entre les deux. Ce paramètre s'exclut mutuellement avec AllowSmallFile. Nœud parent : Filter Nœud enfant : Aucun

En-têtes de réponse

La réponse contient uniquement des en-têtes de réponse courants. Pour plus d'informations, consultez la section En-têtes de réponse courants.

Exemples

Exemples de requêtes

Exemple 1 : Convertir la classe de stockage des objets en fonction de la dernière modification

Dans l'exemple suivant, la classe de stockage des objets avec le préfixe log est convertie vers IA 30 jours après leur dernière modification.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Mon, 6 May 2019 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix>log/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>IA</StorageClass>
    </Transition>    
  </Rule>
</LifecycleConfiguration>

Exemple 2 : Supprimer des objets en fonction de la dernière modification

Dans l'exemple suivant, les objets avec le préfixe log sont supprimés 90 jours après leur dernière modification.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix>log/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>90</Days>
    </Expiration>    
 </Rule>
</LifecycleConfiguration>

Exemple 3 : Convertir la classe de stockage des objets et les supprimer en fonction de la dernière modification

La règle suivante effectue ces actions sur les objets avec le préfixe log : conversion de leur classe de stockage vers IA 30 jours après leur dernière modification, conversion vers Archive Storage après 60 jours et suppression après 3 600 jours.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix>log/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>IA</StorageClass>
    </Transition>
    <Transition>
      <Days>60</Days>
      <StorageClass>Archive</StorageClass>
    </Transition>
    <Expiration>
      <Days>3600</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Exemple 4 : Supprimer les versions précédentes des objets et nettoyer les marqueurs de suppression en fonction de la dernière modification

La règle suivante supprime les objets 5 jours après qu'ils soient devenus des versions précédentes et nettoie les marqueurs de suppression après la suppression de toutes les versions précédentes.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix></Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <ExpiredObjectDeleteMarker>true</ExpiredObjectDeleteMarker>
    </Expiration>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>5</NoncurrentDays>
    </NoncurrentVersionExpiration>    
  </Rule>
</LifecycleConfiguration>

Exemple 5 : Convertir la classe de stockage des objets et les supprimer en fonction de la dernière modification, en excluant les objets avec un préfixe et un tag spécifiques

La règle suivante utilise l'élément NOT pour le filtrage. Cette règle s'applique à tous les objets du bucket, à l'exception de ceux ayant le préfixe 'log' et le tag Key=key1, Value=value1. La classe de stockage des objets correspondants est convertie vers Archive Storage 30 jours après leur dernière modification, et les objets sont supprimés après 100 jours.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix></Prefix>
    <Status>Enabled</Status>
    <Filter>
      <Not>
        <Prefix>log</Prefix>
        <Tag><Key>key1</Key><Value>value1</Value></Tag>
      </Not>
    </Filter>    
    <Transition>
      <Days>30</Days>
      <StorageClass>Archive</StorageClass>
    </Transition>
    <Expiration>
      <Days>100</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Exemple 6 : Convertir la classe de stockage des objets en fonction du dernier accès

La règle suivante convertit la classe de stockage des objets avec le préfixe log vers IA 30 jours après leur dernier accès. Lorsque ces objets sont à nouveau consultés, leur classe de stockage est reconvertie vers Standard.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix>log/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>IA</StorageClass>
      <IsAccessTime>true</IsAccessTime>
      <ReturnToStdWhenVisit>true</ReturnToStdWhenVisit>
    </Transition>
  </Rule>
</LifecycleConfiguration>

Exemple 7 : Supprimer des parties en fonction de la dernière modification

La règle suivante supprime les parties d'un bucket créées il y a plus de 30 jours.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>rule</ID>
    <Prefix>/</Prefix>
    <Status>Enabled</Status>    
    <AbortMultipartUpload>
      <Days>30</Days>
    </AbortMultipartUpload>
 </Rule>
</LifecycleConfiguration>

Exemple 8 : Supprimer des objets avec des préfixes qui se chevauchent en fonction de la dernière modification

La règle suivante spécifie que les objets du dossier dir1/ sont supprimés 180 jours après leur dernière modification, et que les objets du sous-dossier dir1/dir2/ sont supprimés 30 jours après leur dernière modification.

PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 336
Date: Thu, 17 Apr 2025 15:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-allow-same-action-overlap: true
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
  <Rule>
    <ID>Rule1</ID>
    <Prefix>dir1/</Prefix>
    <Status>Status</Status>
    <Expiration>
      <Days>180</Days>
    </Expiration>
  </Rule>
  <Rule>
    <ID>Rule2</ID>
    <Prefix>dir1/dir2/</Prefix>
    <Status>Status</Status>
    <Expiration>
      <Days>30</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Remarque

Si x-oss-allow-same-action-overlap est défini sur false, OSS détecte que les objets du dossier dir1/dir2/ correspondent à deux règles de suppression. Dans ce cas, OSS rejette la configuration de ces deux règles de cycle de vie et signale l'erreur Overlap for same action type Expiration.

Exemple de réponse

HTTP/1.1 200 OK
x-oss-request-id: 7D3435J59A9812BAD56E
Date: Mon, 6 May 2019 15:23:20 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK

Appelez cette opération à l'aide des kits de développement logiciel (SDK) pour les langages de programmation suivants.

Outil de ligne de commande ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération PutBucketLifecycle, consultez la section put-bucket-lifecycle.

Références

Pour plus d'informations sur les règles de cycle de vie, consultez la section Présentation des règles de cycle de vie.

Codes d'erreur

Code d'erreur	Code d'état HTTP	Description
InvalidArgument	400	Causes possibles de cette erreur : OSS prend en charge la conversion des objets Standard d'un bucket Standard vers la classe de stockage IA ou Archive Storage. Vous pouvez configurer des règles pour convertir un objet vers IA et Archive Storage à des moments différents, mais la date de conversion vers Archive Storage doit être postérieure à celle de la conversion vers IA. La date d'expiration d'un objet doit être postérieure à la date de conversion de l'objet vers la classe de stockage IA ou Archive Storage.
AccessDenied	403	Vous ne disposez pas des autorisations requises. Seuls les utilisateurs disposant de l'autorisation `oss:PutBucketLifecycle` peuvent configurer des règles de cycle de vie.
MalforedXML	400	Une erreur de validation XML dans la configuration du cycle de vie entraîne l'erreur MalformedXML. Par exemple, cette erreur se produit si vous configurez une règle de cycle de vie basée sur le dernier accès pour un bucket avant d'avoir activé le suivi d'accès pour ce bucket.