Éléments de la configuration du cycle de vie

Des métadonnées de règle comprenant un ID de règle et un statut indiquant si la règle est activée ou non. Si une règle est désactivée, Amazon S3 n’exécute aucune action spécifiée dans la règle.

Un filtre qui identifie les objets auxquels la règle s’applique. Vous pouvez spécifier un filtre en utilisant la taille de l’objet, le préfixe de clé d’objet, une ou plusieurs balises d’objet, ou une combinaison de filtres.

Une ou plusieurs actions de transition ou d’expiration avec une date ou une durée dans le cycle de vie de l’objet lorsque vous voulez qu’Amazon S3 exécute l’action spécifiée.

Spécification d’un filtre à l’aide de préfixes de clé : cet exemple montre une règle de cycle de vie S3 qui s’applique à un sous-ensemble d’objets en fonction du préfixe du nom de clé (logs/). Par exemple, la règle de cycle de vie s’applique aux objets logs/mylog.txt, logs/temp1.txt et logs/test.txt. La règle ne s’applique pas à l’objet example.jpg.

<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Prefix>logs/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>
    ...
</LifecycleConfiguration>

Si vous souhaitez appliquer une action de cycle de vie à un sous-ensemble d’objets en fonction de préfixes de noms de clé différents, spécifiez des règles distinctes. Dans chaque règle, spécifiez un filtre basé sur le préfixe. Par exemple, pour décrire une action de cycle de vie pour les objets avec les préfixes de clé projectA/ et projectB/, vous spécifiez deux règles comme suit :

<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Prefix>projectA/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>

    <Rule>
        <Filter>
           <Prefix>projectB/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>
</LifecycleConfiguration>

Pour en savoir plus sur les clés d’objet, consultez Attribution d’un nom aux objets Amazon S3.

Spécification d’un filtre en fonction de balises d’objet : dans l’exemple suivant, la règle de cycle de vie spécifie un filtre basé sur une balise (key) et une valeur (value). La règle s’applique ensuite uniquement à un sous-ensemble d’objets avec la balise spécifique.

<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Tag>
              <Key>key</Key>
              <Value>value</Value>
           </Tag>
        </Filter>
        transition/expiration actions
        ...
    </Rule>
</LifecycleConfiguration>

Vous pouvez spécifier un filtre basé sur plusieurs balises. Vous devez encapsuler les balises dans l’élément <And>, comme illustré dans l’exemple suivant. La règle indique à Amazon S3 d’exécuter des actions de cycle de vie sur des objets avec deux balises (avec la clé de balise et la valeur spécifiques).

<LifecycleConfiguration>
    <Rule>
      <Filter>
         <And>
            <Tag>
               <Key>key1</Key>
               <Value>value1</Value>
            </Tag>
            <Tag>
               <Key>key2</Key>
               <Value>value2</Value>
            </Tag>
             ...
          </And>
      </Filter>
      transition/expiration actions
    </Rule>
</Lifecycle>

La règle de cycle de vie s’applique aux objets qui ont tous deux des balises spécifiées. Amazon S3 effectue une opération logique AND. Remarques :

Spécification d’un filtre basé à la fois sur le préfixe et sur une ou plusieurs balises : dans une règle de cycle de vie, vous pouvez spécifier un filtre basé à la fois sur le préfixe de clé et sur une ou plusieurs balises. Là encore, vous devez encapsuler tous ces éléments de filtre dans l’élément <And>, comme suit :

<LifecycleConfiguration>
    <Rule>
        <Filter>
          <And>
             <Prefix>key-prefix</Prefix>
             <Tag>
                <Key>key1</Key>
                <Value>value1</Value>
             </Tag>
             <Tag>
                <Key>key2</Key>
                <Value>value2</Value>
             </Tag>
              ...
          </And>
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

Amazon S3 associe ces filtres à l’aide d’un opérateur logique AND. Autrement dit, la règle s’applique au sous-ensemble des objets dotés du préfixe de clé spécifié et des balises spécifiées. Un filtre peut avoir seulement un préfixe et zéro, une ou plusieurs balises.

Vous pouvez spécifier un filtre vide, auquel cas la règle s’applique à tous les objets dans le compartiment.

<LifecycleConfiguration>
    <Rule>
        <Filter>
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

Pour filtrer une règle par taille d’objet, vous pouvez spécifier une taille minimale (ObjectSizeGreaterThan) ou une taille maximale (ObjectSizeLessThan), ou vous pouvez spécifier une plage de tailles d’objet.

Les valeurs de taille d’objet sont exprimées en octets. Par défaut, les objets de moins de 128 Ko ne seront transférés vers aucune classe de stockage, sauf si vous spécifiez une taille minimale (ObjectSizeGreaterThan) inférieure ou une taille maximale (ObjectSizeLessThan). Pour de plus amples informations, veuillez consulter Exemple : permettre la transition d’objets de moins de 128 Ko.

                    <LifecycleConfiguration>
    <Rule>
        <Filter>
            <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>   
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

Si vous spécifiez une plage de tailles d’objet, l’entier ObjectSizeGreaterThan doit être inférieur à la valeur ObjectSizeLessThan. Si vous utilisez plusieurs filtres, vous devez les envelopper dans un élément <And>. L’exemple suivant montre comment spécifier des objets dans une plage comprise entre 500 et 64 000 octets.

<LifecycleConfiguration>
    <Rule>
        <Filter>
            <And>
                <Prefix>key-prefix</Prefix>
                <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>
                <ObjectSizeLessThan>64000</ObjectSizeLessThan>
            </And>    
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

Élément d’action Transition : vous spécifiez l’action Transition pour transférer les objets d’une classe de stockage vers une autre. Pour en savoir plus sur la transition d’objets, consultez Transitions prises en charge. Lorsqu’une date ou une durée spécifiée dans le cycle de vie d’un objet est atteinte, Amazon S3 effectue la transition.

Pour un compartiment avec gestion des versions (compartiment activé pour la gestion des versions ou suspendu pour la gestion des versions), l’action Transition s’applique à la version d’objet actuelle. Pour gérer des versions anciennes, Amazon S3 définit l’action NoncurrentVersionTransition (décrite ultérieurement dans cette rubrique).

Élément d’action Expiration : l’action Expiration fait expirer les objets identifiés dans la règle et s’applique aux objets éligibles dans l’une des classes de stockage Amazon S3. Pour plus d'informations sur les classes de stockage, consultez Bien comprendre et gérer les classes de stockage Amazon S3. Amazon S3 rend tous les objets expirés indisponibles. Que les objets soient supprimés définitivement ou pas dépend de l’état de la gestion des versions du compartiment.

Élément d’action NoncurrentVersionTransition : utilisez cette action pour spécifier quand Amazon S3 doit transférer des objets vers la classe de stockage spécifiée. Vous pouvez baser cette transition sur le nombre de jours écoulés depuis que les objets sont devenus non courants (<NoncurrentDays>). Outre le nombre de jours, vous pouvez également spécifier le nombre de versions non actuelles (<NewerNoncurrentVersions>) à conserver (entre 1 et 100). Cette valeur détermine le nombre de nouvelles versions non actuelles qui doivent exister avant qu'Amazon S3 puisse effectuer la transition vers une version donnée. Amazon S3 transférera toutes les versions non actuelles supplémentaires au-delà du nombre spécifié à conserver. Pour que la transition se produise, les valeurs <NoncurrentDays> et les <NewerNoncurrentVersions> valeurs doivent être dépassées.

Pour spécifier le nombre de versions non actuelles à conserver, vous devez également fournir un <Filter> élément. Si vous ne spécifiez aucun <Filter> élément, Amazon S3 génère une InvalidRequest erreur lorsque vous spécifiez le nombre de versions non actuelles à conserver.

Pour en savoir plus sur la transition d’objets, consultez Transitions prises en charge. Pour plus de détails sur la façon dont Amazon S3 calcule la date lorsque vous spécifiez le nombre de jours dans l’action NoncurrentVersionTransition, consultez Règles de cycle de vie : en fonction de l’âge de l’objet.

Élément d’action NoncurrentVersionExpiration : utilisez cette action pour indiquer à Amazon S3 de supprimer définitivement les versions non actuelles des objets. Les objets supprimés ne peuvent pas être récupérés. Vous pouvez baser cette expiration sur un certain nombre de jours depuis que les objets sont devenus caducs (<NoncurrentDays>). Outre le nombre de jours, vous pouvez également spécifier le nombre de versions non actuelles (<NewerNoncurrentVersions>) à conserver (entre 1 et 100). Cette valeur indique le nombre de nouvelles versions non actuelles qui doivent exister avant qu'Amazon S3 puisse expirer une version donnée. Amazon S3 supprime définitivement toutes les versions non actuelles supplémentaires au-delà du nombre spécifié à conserver. Pour que la suppression ait lieu, les valeurs <NoncurrentDays> et les <NewerNoncurrentVersions> valeurs doivent être dépassées.

Pour spécifier le nombre de versions non actuelles à conserver, vous devez également fournir un <Filter> élément. Si vous ne spécifiez aucun <Filter> élément, Amazon S3 génère une InvalidRequest erreur lorsque vous spécifiez le nombre de versions non actuelles à conserver.

La suppression retardée d’objets anciens peut être utile lorsque vous avez besoin de corriger des suppressions ou des remplacements accidentels. Par exemple, vous pouvez configurer une règle d’expiration pour supprimer les versions anciennes cinq jours après qu’elles soient devenues anciennes. Par exemple, supposons que le 01/01/2014, à 10 h 30 UTC, vous créez un objet appelé photo.gif (ID de version 111111). Le 02/01/2014 à 11 h 30 UTC, vous supprimez par inadvertance photo.gif (ID de version 111111), ce qui crée un marqueur de suppression avec un nouvel ID de version (tel que l’ID de version 4857693). Vous avez à présent cinq jours pour récupérer la version d’origine de photo.gif (ID de version 111111) avant que la suppression ne soit définitive. Le 08/01/2014 à 00 h 00 UTC, la règle de cycle de vie pour l’expiration s’exécute et supprime définitivement photo.gif (ID de version 111111), cinq jours après qu’il est devenu une version non actuelle.

Pour plus de détails sur la façon dont Amazon S3 calcule la date lorsque vous spécifiez le nombre de jours dans une action NoncurrentVersionExpiration, consultez Règles de cycle de vie : en fonction de l’âge de l’objet.

Élément d’action AbortIncompleteMultipartUpload : utilisez cet élément pour définir une durée maximale (en jours) pendant laquelle vous souhaitez autoriser la poursuite des chargements partitionnés. Si les chargements partitionnés applicables (déterminés par le nom de clé prefix spécifié dans la règle de cycle de vie) ne sont pas correctement menés à terme dans la période prédéfinie, Amazon S3 arrête les chargements partitionnés incomplets. Pour de plus amples informations, veuillez consulter Interruption d’un chargement partitionné.

Élément d’action ExpiredObjectDeleteMarker : dans un compartiment avec gestion des versions, un marqueur de suppression sans aucune version non actuelle est désigné en tant que marqueur de suppression d’objet expiré. Vous pouvez utiliser cette action de cycle de vie pour indiquer à Amazon S3 de supprimer les marqueurs de suppression d’objets expirés. Pour obtenir un exemple, consultez Suppression des marqueurs de suppression des objets expirés dans un compartiment avec gestion des versions.

La valeur que vous spécifiez correspond au nombre de jours écoulés depuis la création de l’objet au cours desquels l’action se produira.

Amazon S3 calcule ce délai en ajoutant le nombre de jours spécifié dans la règle à la date et à l’heure de création de l’objet et en arrondissant la date et l’heure obtenues au jour suivant à minuit, heure UTC. Par exemple, si un objet a été créé le 15/01/2014 à 10 h 30 UTC et que vous spécifiez 3 jours dans une règle de transition, la date calculée de transition de l’objet sera le 19/01/2014 à 00 h 00 UTC.

La valeur que vous spécifiez correspond au nombre de jours depuis le moment où l’objet devient non actuel (c’est-à-dire, depuis que l’objet a été remplacé ou supprimé) pendant lesquels Amazon S3 effectuera l’action sur l’objet ou les objets spécifiés.

Amazon S3 calcule ce délai en ajoutant le nombre de jours spécifié dans la règle à l’heure à laquelle la nouvelle version du successeur de l’objet est créée, puis en arrondissant la date et l’heure obtenues au jour suivant à minuit, heure UTC. Par exemple, dans votre compartiment, supposons que vous ayez une version actuelle d’un objet, créée le 01/01/2014 à 10 h 30 UTC. Si la nouvelle version de l’objet qui remplace la version actuelle a été créée le 15/01/2014 à 10 h 30 UTC et que vous spécifiez 3 jours dans une règle de transition, la date de transition de l’objet sera le 19/01/2014 à 00 h 00 UTC.