Aggiungere filtri alle regole del ciclo di vita

I filtri sono un elemento opzionale della regola del ciclo di vita che puoi utilizzare per specificare a quali oggetti si applica la regola.

I seguenti elementi possono essere utilizzati per filtrare gli oggetti:

Prefisso chiave: È possibile filtrare gli oggetti in base a un prefisso. Se desideri applicare le azioni del ciclo di vita (un sottoinsieme di oggetti sotto più di un prefisso), puoi specificare regole separate. all'interno di ognuna, specificare un filtro basato sul prefisso. Per ulteriori informazioni, vedere [esempio]
Tag degli oggetti: È possibile filtrare gli oggetti in base a uno o più tag. Ogni tag deve corrispondere esattamente alla chiave e al valore e, se si specificano più tag, ogni chiave di tag deve essere unica. Un filtro con più tag di oggetto si applica a un sottoinsieme di oggetti in cui sono specificati tutti i tag. Se per un oggetto sono stati specificati tag aggiuntivi, il filtro verrà comunque applicato.
Nota
Se specificate solo un Key elemento e nessun Value elemento, la regola verrà applicata solo agli oggetti che corrispondono alla chiave del tag e che non hanno un valore specificato.
Dimensione minima o massima dell'oggetto: È possibile filtrare gli oggetti in base alle dimensioni. È possibile specificare una dimensione minima (ObjectSizeGreaterThan) o una dimensione massima (ObjectSizeLessThan) oppure è possibile specificare un intervallo di dimensioni degli oggetti nello stesso filtro. I valori delle dimensioni degli oggetti sono espressi in byte. La dimensione massima del filtro è di 5 TB. Amazon S3 applica una dimensione minima dell'oggetto predefinita alla configurazione del ciclo di vita. Per ulteriori informazioni, consulta Esempio: consentire la transizione di oggetti di dimensioni inferiori a 128 KB.

Puoi combinare diversi elementi di filtro, nel qual caso Amazon S3 utilizza una logica. AND

Esempi di filtri

Gli esempi seguenti mostrano come utilizzare diversi elementi di filtro:

Specificazione di un filtro utilizzando prefissi chiave: questo esempio mostra una regola del ciclo di vita S3 che si applica a un sottoinsieme di oggetti in base al prefisso del nome chiave (). logs/ Ad esempio, la regola del ciclo di vita si applica agli oggetti, e. logs/mylog.txt logs/temp1.txt logs/test.txt ma non per l'oggetto example.jpg.
```
<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Prefix>logs/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>
    ...
</LifecycleConfiguration>
```
Nota
Se avete uno o più prefissi che iniziano con gli stessi caratteri, potete includere tutti questi prefissi nella regola specificando un prefisso parziale senza barra finale () nel filtro. / Ad esempio, supponiamo di avere questi prefissi:
```
sales1999/
                sales2000/
                sales2001/
```
Per includere tutti e tre i prefissi nella regola, specificateli sales come prefisso nella regola del ciclo di vita.
Se desideri applicare un'azione del ciclo di vita a un sottoinsieme di oggetti in base a prefissi di nomi chiave diversi, specifica regole separate. all'interno di ognuna, specificare un filtro basato sul prefisso. Ad esempio, per descrivere un'azione del ciclo di vita per gli oggetti con i prefissi chiave e, specificate projectA/ due regole come segue: projectB/
```
<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Prefix>projectA/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>

    <Rule>
        <Filter>
           <Prefix>projectB/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>
</LifecycleConfiguration>
```
Per ulteriori informazioni sulle chiavi degli oggetti, consulta Denominazione degli oggetti Amazon S3.
Specificazione di un filtro basato sui tag degli oggetti: nell'esempio seguente, la regola del ciclo di vita specifica un filtro basato su un tag () e un valore (). key value La regola si applica quindi solo a un sottoinsieme di oggetti con quel tag specifico.
```
<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Tag>
              <Key>key</Key>
              <Value>value</Value>
           </Tag>
        </Filter>
        transition/expiration actions
        ...
    </Rule>
</LifecycleConfiguration>
```
È possibile specificare un filtro basato su più tag. È necessario racchiudere i tag nell'<And>elemento, come illustrato nell'esempio seguente. La regola indica ad Amazon S3 di eseguire le operazioni del ciclo di vita sugli oggetti con due tag (con la specifica combinazione di chiave e valore).
```
<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 regola del ciclo di vita si applica agli oggetti che contengono entrambi i tag specificati. Amazon S3 esegue un'operazione logica AND. Tieni presente quanto segue:
- Ogni tag deve corrispondere esattamente alla chiave e al valore. Se specificate solo un <Key> elemento e nessun <Value> elemento, la regola verrà applicata solo agli oggetti che corrispondono alla chiave del tag e che non hanno un valore specificato.
- La regola si applica a un sottoinsieme di oggetti che ha tutti i tag specificati nella regola. Se a un oggetto sono specificati tag aggiuntivi, la regola verrà comunque applicata.
Nota
Quando si specificano più tag in un filtro, ogni chiave del tag deve essere univoca.
Specificazione di un filtro basato sia sul prefisso che su uno o più tag: in una regola del ciclo di vita, puoi specificare un filtro basato sia sul prefisso chiave che su uno o più tag. Anche in questo caso, è necessario racchiudere tutti questi elementi del filtro nell'elemento, come segue<And>:
```
<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 combina questi filtri utilizzando una logica. AND Cioè, la regola si applica al sottoinsieme di oggetti con il prefisso chiave specificato e i tag specificati. Un filtro può avere un solo prefisso e zero o più tag.

Specificazione di un filtro vuoto: è possibile specificare un filtro vuoto, nel qual caso la regola si applica a tutti gli oggetti nel bucket.


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

>Specificazione di un filtro per le dimensioni dell'oggetto: per filtrare una regola in base alla dimensione dell'oggetto, è possibile specificare una dimensione minima (ObjectSizeGreaterThan) o una dimensione massima (ObjectSizeLessThan) oppure è possibile specificare un intervallo di dimensioni degli oggetti.

I valori delle dimensioni degli oggetti sono espressi in byte. La dimensione massima del filtro è di 5 TB. Alcune classi di archiviazione hanno limiti minimi di dimensione degli oggetti. Per ulteriori informazioni, consulta Confronto delle classi di storage di Amazon S3.
```
<LifecycleConfiguration>
    <Rule>
        <Filter>
            <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>   
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>
```
Nota
I ObjectSizeLessThan filtri ObjectSizeGreaterThan and escludono i valori specificati. Ad esempio, se imposti oggetti con dimensioni da 128 KB a 1024 KB per spostarli dalla classe di storage S3 Standard alla classe di storage S3 Standard-IA, gli oggetti che sono esattamente 1024 KB e 128 KB non passeranno a S3 Standard-IA. La regola si applicherà invece solo agli oggetti con dimensioni superiori a 128 KB e inferiori a 1024 KB.

Se stai specificando un intervallo di dimensioni degli oggetti, il numero intero ObjectSizeGreaterThan deve essere minore del valore ObjectSizeLessThan. Quando si utilizzano più filtri, è necessario racchiudere i filtri in un elemento <And>. L'esempio seguente mostra come specificare oggetti in un intervallo compreso tra 500 byte e 64.000 byte.
```
<LifecycleConfiguration>
    <Rule>
        <Filter>
            <And>
                <Prefix>key-prefix</Prefix>
                <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>
                <ObjectSizeLessThan>64000</ObjectSizeLessThan>
            </And>    
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>
```

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Elementi della configurazione del ciclo di vita

Conflitti di configurazione del ciclo di vita

Aggiungere filtri alle regole del ciclo di vita

Nota

Esempi di filtri

Nota

Nota

Nota