Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
I filtri sono un elemento opzionale delle regole del ciclo di vita che è possibile utilizzare per specificare gli oggetti a cui si applica la regola.
Per filtrare gli oggetti possono essere utilizzati i seguenti elementi:
- Prefisso della chiave
È possibile filtrare gli oggetti in base a un prefisso. Per applicare operazioni del ciclo di vita a un sottoinsieme di oggetti in più di un prefisso, specificare regole separate e, all'interno di ognuna, specificare un filtro basato sul prefisso. Per ulteriori informazioni, consulta [esempio]
- Tag dell'oggetto
È possibile filtrare gli oggetti in base a uno o più tag. Ogni tag deve corrispondere esattamente sia alla chiave che al valore e, se si specificano più tag, ogni chiave del tag deve essere univoca. Un filtro con più tag dell'oggetto si applica a un sottoinsieme di oggetti con tutti i tag specificati. Se per un oggetto sono specificati tag aggiuntivi, il filtro verrà comunque applicato.
Nota
Se si specifica solo un elemento
Key
e nessun elementoValue
, 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 alla dimensione. È possibile specificare una dimensione minima (
ObjectSizeGreaterThan
) o una dimensione massima (ObjectSizeLessThan
) oppure è possibile specificare un intervallo di dimensioni dell'oggetto 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.
È possibile combinare diversi elementi di filtro, nel qual caso Amazon S3 utilizza un operatore AND
logico.
Esempi di filtri
Di seguito sono riportati esempi che mostrano come è possibile utilizzare diversi elementi di filtro:
-
Definizione di un filtro tramite prefissi della chiave: questo esempio illustra una regola del ciclo di vita S3 valida per un sottoinsieme di oggetti in base al prefisso del nome della chiave (
logs/
). Ad esempio, la regola del ciclo di vita è valida per gli oggettilogs/mylog.txt
,logs/temp1.txt
elogs/test.txt
. ma non per l'oggettoexample.jpg
.<LifecycleConfiguration> <Rule> <Filter> <Prefix>logs/</Prefix> </Filter>
transition/expiration actions
... </Rule> ... </LifecycleConfiguration>Nota
Se si hanno uno o più prefissi che iniziano con gli stessi caratteri, è possibile includere tutti questi prefissi nella regola specificando un prefisso parziale senza barra finale (
/
) nel filtro. Ad esempio, supponiamo di avere i seguenti prefissi:sales1999/ sales2000/ sales2001/
Per includere tutti e tre i prefissi nella regola, specificare
sales
come prefisso nella regola del ciclo di vita.Per applicare un'operazione per il ciclo di vita a un sottoinsieme di oggetti in base a diversi prefissi del nome della chiave, specificare regole separate e, all'interno di ognuna, specificare un filtro basato sul prefisso. Ad esempio, per descrivere un'operazione per il ciclo di vita per oggetti con prefissi della chiave
projectA/
eprojectB/
, vanno specificate due regole, come illustrato di seguito:<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 di oggetti Amazon S3.
-
Definizione di un filtro in base ai tag dell'oggetto: nell'esempio che segue la regola del ciclo di vita specifica un filtro basato su un tag (
) e un valore (key
). La regola si applica quindi solo a un sottoinsieme di oggetti con quel tag specifico.value
<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'elemento
<And>
illustrato nell'esempio che segue. 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 sia alla chiave che al valore. Se si specifica solo un elemento
<Key>
e nessun elemento<Value>
, 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.
-
-
Definizione di un filtro in base al prefisso e a uno o più tag: in una regola del ciclo di vita è possibile specificare un filtro in base al prefisso della chiave e a uno o più tag. Anche in questo caso, è necessario racchiudere tutti gli elementi del filtro nell'elemento
<And>
, come illustrato di seguito.<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 tramite l'operatore logico
AND
. In altre parole, la regola si applica al sottoinsieme di oggetti con il prefisso della chiave e i tag specificati. Un filtro può avere un solo prefisso e zero o più tag. -
Definizione 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> -
Definizione di un filtro per le dimensioni degli oggetti: per filtrare una regola per dimensione oggetto, è possibile specificare una dimensione minima (
ObjectSizeGreaterThan
) o 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 storage presentano limitazioni relative alle dimensioni minime 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 filtri
ObjectSizeGreaterThan
eObjectSizeLessThan
escludono i valori specificati. Ad esempio, se si imposta il passaggio degli oggetti di dimensioni comprese tra 128 KB e 1024 KB dalla classe di storage S3 Standard alla classe di storage AI S3 Standard, gli oggetti di dimensioni esattamente pari a 1024 KB e 128 KB non passeranno alla classe AI S3 Standard. 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 valoreObjectSizeLessThan
. Quando si utilizzano più filtri, è necessario racchiudere i filtri in un elemento<And>
. L'esempio seguente illustra come specificare gli oggetti in un intervallo compreso tra 500 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>