Ajout de filtres à des règles de cycle de vie - Amazon Simple Storage Service
Exemples de filtre

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.

Ajout de filtres à des règles de cycle de vie

Les filtres sont un élément facultatif de règle de cycle de vie que vous pouvez utiliser pour spécifier les objets auxquels la règle s’applique.

Les éléments suivants peuvent être utilisés pour filtrer les objets :

Préfixe de clé

Vous pouvez filtrer les objets en fonction d’un préfixe. Si vous souhaitez appliquer une action du cycle de vie à un sous-ensemble d'objets avec des préfixes différents, créez des règles distinctes pour chaque action.

Balises d’objet

Vous pouvez filtrer les objets en fonction d’une ou de plusieurs balises. Chaque balise doit correspondre exactement à la clé et à la valeur et, si vous spécifiez plusieurs balises, chaque clé de balise doit être unique. Un filtre avec plusieurs balises d’objet s’applique à un sous-ensemble d’objets dont toutes les balises sont spécifiées. Si un objet dispose de balises supplémentaires spécifiées, le filtre continue de s’appliquer.

Note

Si vous spécifiez uniquement un élément Key et aucun élément Value, la règle ne s’applique qu’aux objets correspondant à la clé de balise et pour lesquels aucune valeur n’est spécifiée.

Taille d’objet minimale ou maximale

Vous pouvez filtrer les objets en fonction de leur taille. Vous pouvez spécifier une taille minimale (ObjectSizeGreaterThan) ou une taille maximale (ObjectSizeLessThan), ou vous pouvez spécifier une plage de tailles d’objet dans le même filtre. Les valeurs de taille d’objet sont exprimées en octets. La taille de filtre maximale est de 5 To. Amazon S3 applique une taille d’objet minimale par défaut à la configuration du cycle de vie. Pour de plus amples informations, veuillez consulter Exemple : permettre la transition d’objets de moins de 128 Ko.

Vous pouvez combiner différents éléments de filtre, auquel cas Amazon S3 utilise un opérateur AND logique.

Exemples de filtre

Les exemples suivants montrent comment vous pouvez utiliser différents éléments de filtre :

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

    Si un ou plusieurs préfixes commencent par les mêmes caractères, vous pouvez inclure tous ces préfixes dans votre règle en spécifiant un préfixe partiel sans barre oblique (/) dans le filtre. Par exemple, supposons que vous avez les préfixes suivants :

    sales1999/
                sales2000/
                sales2001/

    Pour inclure ces trois préfixes dans votre règle, spécifiez sales comme préfixe dans votre règle de cycle de vie.

    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 :

    • Chaque balise doit correspondre exactement à la fois à la clé et à la valeur. Si vous spécifiez uniquement un élément <Key> et aucun élément <Value>, la règle ne s’applique qu’aux objets correspondant à la clé de balise et pour lesquels aucune valeur n’est spécifiée.

    • La règle s’applique à un sous-ensemble d’objets dont toutes les étiquettes sont spécifiées dans la règle. Si un objet dispose d’étiquettes supplémentaires spécifiées, la règle continue à s’appliquer.

    Note

    Lorsque vous spécifiez plusieurs balises dans un filtre, chaque clé de balise doit être unique.

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

  • Spécification d’un filtre vide : 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>

  • Spécification d’un filtre de taille d’objet : 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. La taille de filtre maximale est de 5 To. Certaines classes de stockage présentent des limites concernant la taille minimale des objets. Pour de plus amples informations, veuillez consulter Comparaison des classes de stockage Amazon S3.

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

    Les filtres ObjectSizeGreaterThan et ObjectSizeLessThan excluent les valeurs spécifiées. Par exemple, si vous définissez que les objets d’une taille comprise entre 128 Ko et 1 024 Ko doivent passer de la classe de stockage S3 Standard à la classe de stockage S3 Standard-IA, les objets qui font exactement 1 024 Ko ou 128 Ko ne passeront pas à S3 Standard-IA. À la place, la règle s’appliquera uniquement aux objets de plus de 128 Ko et de moins de 1 024 Ko.

    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>