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à.
# Organizzare, elencare e utilizzare gli oggetti
In Amazon S3, puoi utilizzare i prefissi per organizzare lo spazio di storage. Un prefisso è un raggruppamento logico degli oggetti in un bucket. Il valore del prefisso è simile a un nome di directory che consente di archiviare dati simili nella stessa directory in un bucket. Quando si caricano oggetti a livello di programmazione, è possibile utilizzare i prefissi per organizzare i dati.
Nella console di Amazon S3, i prefissi sono chiamati cartelle. È possibile visualizzare tutti gli oggetti e le cartelle nella console S3 passando a un bucket. È inoltre possibile visualizzare informazioni su ciascun oggetto, incluse le proprietà dell'oggetto.
Per ulteriori informazioni sull'elenco e sull'organizzazione dei dati in Amazon S3, consulta i seguenti argomenti.
**Topics**
+ [Organizzazione degli oggetti utilizzando i prefissi](using-prefixes.md)
+ [Elenco delle chiavi oggetto a livello di programmazione](ListingKeysUsingAPIs.md)
+ [Organizzazione degli oggetti nella console di Amazon S3 utilizzando le cartelle](using-folders.md)
+ [Visualizzazione delle proprietà di un oggetto nella console di Amazon S3](view-object-properties.md)
+ [Classificazione degli oggetti utilizzando i tag](object-tagging.md)
# Organizzazione degli oggetti utilizzando i prefissi
Puoi utilizzare i prefissi per organizzare i dati archiviati nei bucket Amazon S3. Un prefisso è una stringa di caratteri all'inizio del nome della chiave dell'oggetto. Un prefisso può essere di qualsiasi lunghezza, soggetto alla lunghezza massima del nome della chiave dell'oggetto (1.024 byte). Puoi pensare ai prefissi come un modo per organizzare i dati in modo simile alle directory. Tuttavia, i prefissi non sono directory.
La ricerca per prefisso limita i risultati solo alle chiavi che iniziano con il prefisso specificato. Il delimitatore fa in modo che l'operazione di elenco esegua il rollup di tutte le chiavi che condividono un prefisso comune in un unico risultato di elenco di riepilogo
Lo scopo dei parametri Prefix e Delimiter è facilitare l'organizzazione e la visualizzazione delle chiavi in ordine gerarchico. A tale scopo, selezionare un delimitatore per il bucket, ad esempio una barra (/), che non ricorra nei nomi delle chiavi previsti. È possibile utilizzare un altro carattere come delimitatore. Non c'è nulla di unico nel carattere slash (/), ma è un delimitatore di prefisso molto comune. Creare quindi i nomi delle chiavi concatenando tutti i livelli della gerarchia e separando ciascun livello con il delimitatore.
Ad esempio, se si archiviano informazioni sulle città, è possibile organizzarle naturalmente in base al continente, quindi in base al paese, alla provincia o allo stato. Poiché questi nomi in genere non contengono punteggiatura, è possibile selezionare la barra (/) come delimitatore. I seguenti esempi mostrano come utilizzare la barra (/) come delimitatore.
+ Europe/France/Nouvelle-Aquitaine/Bordeaux
+ Nord America/Canada/Quebec/Montreal
+ Nord America/USA/Washington/Bellevue
+ Nord America/USA/Washington/Seattle
Se i dati di ogni città del mondo sono stati archiviati in questo modo, sarebbe strano gestire un namespace di chiavi piatto. Utilizzando `Prefix` e `Delimiter` nell'operazione di elenco, puoi usare la gerarchia creata per elencare i dati. Ad esempio, per elencare tutti gli stati degli Stati Uniti, imposta `Delimiter='/'` e `Prefix='North America/USA/'`. Per elencare tutte le province del Canada per le quali sono disponibili dati, imposta `Delimiter='/'` e `Prefix='North America/Canada/'`.
Per ulteriori informazioni su delimitatori, prefissi e cartelle nidificate, consulta [Differenza tra prefissi e cartelle nidificate](https://repost.aws/knowledge-center/s3-prefix-nested-folders-difference).
## Elenco di oggetti utilizzando prefissi e delimitatori
Se richiedi un elenco con un delimitatore, puoi visualizzare la gerarchia a un solo livello, omettendo e riassumendo le chiavi (possibilmente milioni di esse) nidificate ai livelli più profondi. Ad esempio, supponi di avere un bucket (*amzn-s3-demo-bucket*) con le seguenti chiavi:
`sample.jpg`
`photos/2006/January/sample.jpg`
`photos/2006/February/sample2.jpg`
`photos/2006/February/sample3.jpg`
`photos/2006/February/sample4.jpg`
Il bucket di esempio contiene solo l'oggetto `sample.jpg` a livello root. Per elencare solo gli oggetti a livello root nel bucket, invii una richiesta GET nel bucket con il carattere delimitatore della barra (`/`). In risposta, Amazon S3 restituisce la chiave dell'oggetto `sample.jpg` poiché non contiene il carattere delimitatore `/`. Tutte le altre chiavi contengono questo carattere. Amazon S3 raggruppa queste chiavi e restituisce un singolo elemento `CommonPrefixes` con il valore di prefisso `photos/`, che è una sottostringa dall'inizio di queste chiavi alla prima occorrenza del delimitatore specificato.
**Example**
```
1.
2. amzn-s3-demo-bucket
3.
4.
5. 1000
6. /
7. false
8.
9. sample.jpg
10. 2011-07-24T19:39:30.000Z
11. "d1a7fb5eab1c16cb4f7cf341cf188c3d"
12. 6
13.
14. 75cc57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a
15.
16. STANDARD
17.
18.
19. photos/
20.
21.
```
Per ulteriori informazioni sull'elenco delle chiavi oggetto a livello di programmazione, consulta la sezione [Elenco delle chiavi oggetto a livello di programmazione](ListingKeysUsingAPIs.md).
# Elenco delle chiavi oggetto a livello di programmazione
In Amazon S3, le chiavi possono essere elencate per prefisso. È possibile scegliere un prefisso comune per i nomi delle chiavi correlate e contrassegnare queste chiavi con un carattere speciale che delimita la gerarchia. È quindi possibile utilizzare l'operazione elenco per selezionare e sfogliare le chiavi gerarchicamente. Questa operazione è simile all'archiviazione dei file in directory all'interno di un file system.
Amazon S3 visualizza un'operazione di elenco che consente di elencare le chiavi contenute in un bucket. Le chiavi vengono selezionate per l'elenco in base al bucket e al prefisso. Ad esempio, si prenda in considerazione un bucket denominato "`dictionary`" contenente una chiave per ogni parola inglese. È possibile eseguire una chiamata per elencare tutte le chiavi in tale bucket che iniziano con la lettera "q". I risultati dell'elenco vengono sempre restituiti in ordine binario UTF-8.
Sia le operazioni di elenco SOAP che quelle REST restituiscono un documento XML contenente i nomi delle chiavi corrispondenti e informazioni sull'oggetto identificato da ciascuna chiave.
**Nota**
SOAP APIs per Amazon S3 non è disponibile per i nuovi clienti e si avvicina alla fine del ciclo di vita (EOL) il 31 agosto 2025. Ti consigliamo di utilizzare l'API REST o il. AWS SDKs
È possibile raggruppare i gruppi di chiavi che condividono un prefisso che termina con un delimitatore speciale in base al prefisso comune a scopo di elenco. Ciò consente alle applicazioni di organizzare ed esplorare le chiavi in ordine gerarchico, in modo simile all'organizzazione dei file in directory in un file system.
Ad esempio, per estendere il bucket dictionary in modo che contenga altre parole oltre a quelle inglesi, è possibile creare chiavi anteponendo a ciascuna parola un prefisso insieme alla lingua e a un delimitatore, ad esempio "`French/logical`". È possibile utilizzare questo schema di denominazione e la funzione di elenco gerarchico per recuperare un elenco costituito solo dalle parole francesi. È inoltre possibile sfogliare l'elenco di livello superiore delle lingue disponibili senza dover scorrere tutte le chiavi utilizzate in ordine lessicografico. Per ulteriori informazioni su questo tipo di elenco, consulta [Organizzazione degli oggetti utilizzando i prefissi](using-prefixes.md).
**REST API**
Tuttavia, se l'applicazione lo richiede, è possibile inviare richieste REST direttamente. È possibile inviare una richiesta GET per restituire alcuni o tutti gli oggetti in un bucket oppure è possibile utilizzare le policy di selezione per restituire un sottoinsieme degli oggetti in un bucket. Per ulteriori informazioni, consulta l'argomento relativo all'operazione [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) nella *Documentazione di riferimento delle API di Amazon Simple Storage Service*.
**Efficacia dell'implementazione degli elenchi**
Le prestazioni dell'elenco non sono influenzate in modo sostanziale dal numero totale di chiavi nel bucket. Inoltre, non sono influenzate dalla presenza o dall'assenza degli argomenti `delimiter` , `prefix`, `marker` o `maxkeys`.
**Scorrimento dei risultati di più pagine**
Poiché i bucket possono contenere un numero potenzialmente illimitato di chiavi, una query di elenco può restituire un numero estremamente elevato di risultati. Per gestire set di risultati di grandi dimensioni, l'API di Amazon S3 supporta la paginazione per suddividerli in più risposte. Ciascuna risposta delle chiavi di elenco restituisce una pagina contenente fino a 1000 chiavi con un indicatore che specifica se la risposta è troncata. Invii una serie di richieste di chiavi di elenco finché non ricevi tutte le chiavi. AWS Le librerie wrapper SDK forniscono la stessa impaginazione.
## Esempi
Tieni presente che quando elenchi tutti gli oggetti nel bucket, devi disporre dell'autorizzazione `s3:ListBucket`.
------
#### [ CLI ]
**list-objects**
L'esempio seguente utilizza il comando `list-objects` per visualizzare i nomi di tutti gli oggetti del bucket specificato:
```
aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}'
```
L’esempio utilizza l’argomento `--query` per filtrare l’output di `list-objects` fino al valore della chiave e alla dimensione per ogni oggetto
Per ulteriori informazioni sugli oggetti, consulta [Utilizzo degli oggetti in Amazon S3](uploading-downloading-objects.md).
+ *Per i dettagli sull'API, consulta [ListObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects.html)Command Reference.AWS CLI *
**ls**
L'esempio seguente elenca tutti gli oggetti e i prefissi di un bucket utilizzando il comando `ls`.
Per utilizzare questo esempio di comando, sostituisci **amzn-s3-demo-bucket** con il nome del bucket.
```
$ aws s3 ls s3://amzn-s3-demo-bucket
```
+ Per ulteriori informazioni sul comando di alto livello `ls`, consulta [Elenco di bucket e oggetti](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets) nella *Guida all'utente AWS Command Line Interface *.
------
#### [ PowerShell ]
**Strumenti per PowerShell V4**
**Esempio 1: questo comando recupera le informazioni su tutti gli elementi presenti nel bucket "test-files".**
```
Get-S3Object -BucketName amzn-s3-demo-bucket
```
**Esempio 2: questo comando recupera le informazioni sull’elemento "sample.txt" dal bucket "test-files".**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Esempio 3: questo comando recupera le informazioni su tutti gli elementi con il prefisso "sample" dal bucket "test-files".**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
```
+ Per i dettagli sull'API, vedere [ListObjects](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4).
**Strumenti per V5 PowerShell **
**Esempio 1: questo comando recupera le informazioni su tutti gli elementi presenti nel bucket "test-files".**
```
Get-S3Object -BucketName amzn-s3-demo-bucket
```
**Esempio 2: questo comando recupera le informazioni sull’elemento "sample.txt" dal bucket "test-files".**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Esempio 3: questo comando recupera le informazioni su tutti gli elementi con il prefisso "sample" dal bucket "test-files".**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
```
+ Per i dettagli sull'API, vedere [ListObjects](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5).
------
# Organizzazione degli oggetti nella console di Amazon S3 utilizzando le cartelle
In Amazon S3 bucket per uso generico e oggetti sono risorse primarie, dove gli oggetti sono archiviati nei bucket. I bucket per uso generico di Amazon S3 hanno una struttura piatta anziché gerarchica come quella che si vedrebbe in un file system. Tuttavia, per semplicità di organizzazione, la console di Amazon S3 supporta il concetto di *cartella* come metodo di raggruppamento degli oggetti. La console esegue questa operazione utilizzando un *prefisso* di nome condiviso per gli oggetti raggruppati. In altre parole, gli oggetti del gruppo hanno nomi che iniziano con una stringa comune. Questa stringa comune, o prefisso condiviso, è il nome della cartella. I nomi degli oggetti sono inoltre noti come *nomi chiave*.
È possibile, ad esempio, creare una cartella in un bucket per uso generico nella console denominata `photos` e archiviarvi un oggetto denominato `myphoto.jpg`. Tale oggetto viene quindi memorizzato con il nome delle chiave `photos/myphoto.jpg`, di cui `photos/` è il prefisso.
Ecco altri due esempi:
+ Se il bucket per uso generico contiene tre oggetti, `logs/date1.txt`, `logs/date2.txt` e `logs/date3.txt`, la console mostrerà una cartella denominata `logs`. Se si apre la cartella nella console, si vedranno tre oggetti: `date1.txt`, `date2.txt` e `date3.txt`.
+ Se è presente un oggetto denominato `photos/2017/example.jpg`, la console mostra una cartella denominata `photos` contenente la cartella `2017`. La cartella `2017` contiene l’oggetto `example.jpg`.
Si possono avere cartelle nidificate, ma non bucket all'interno di altri bucket. È possibile caricare e copiare gli oggetti direttamente in una cartella. Le cartelle possono essere create, eliminate e rese pubbliche, ma non possono essere rinominate. Gli oggetti possono essere copiati da una cartella all'altra.
**Importante**
Quando nella console Amazon S3 si crea una cartella, S3 crea un oggetto a 0 byte. Questa chiave dell’oggetto è impostata sul nome della cartella che fornito più un carattere barra (`/`) finale. Ad esempio, se nella console Amazon S3 si crea una cartella denominata `photos` nel bucket, la console Amazon S3 crea un oggetto a 0 byte con la chiave `photos/`. La console crea questo oggetto a supporto del concetto di cartella.
Inoltre, qualsiasi oggetto preesistente il cui nome termina con il carattere barra (`/`) viene visualizzato come cartella nella console Amazon S3. Ad esempio, un oggetto con il nome della chiave `examplekeyname/` viene visualizzato come cartella nella console Amazon S3 e non come oggetto. Altrimenti, si comporta come qualsiasi altro oggetto e può essere visualizzato e manipolato tramite l'API AWS Command Line Interface (AWS CLI) o REST. AWS SDKs Inoltre, non è possibile caricare un oggetto con un nome di chiave che termina con il carattere barra (`/`) mediante la console Amazon S3. Tuttavia, puoi caricare oggetti denominati con un carattere slash (`/`) finale utilizzando () o l' AWS Command Line Interface API AWS CLI REST. AWS SDKs
Inoltre, la console Amazon S3 non mostra il contenuto e i metadati per gli oggetti cartella analogamente ad altri oggetti. Quando si utilizza la console per copiare un oggetto il cui nome termina con il carattere barra (`/`), viene creata una nuova cartella nella posizione di destinazione, ma i dati e i metadati dell’oggetto non vengono copiati. Inoltre, la barra (`/`) nei nomi di chiave degli oggetti potrebbe richiedere una gestione speciale. Per ulteriori informazioni, consulta [Denominazione di oggetti Amazon S3](object-keys.md).
Per creare le cartelle nei bucket di directory, carica una cartella. Per ulteriori informazioni, consulta [Caricamento di oggetti in un bucket di directory](directory-buckets-objects-upload.md).
**Topics**
+ [Creazione di una cartella](#create-folder)
+ [Creazione di cartelle pubbliche](#public-folders)
+ [Calcolo delle dimensioni delle cartelle](#calculate-folder)
+ [Eliminazione di cartelle](#delete-folders)
## Creazione di una cartella
Questa sezione spiega come utilizzare la console di Amazon S3 per creare una cartella.
**Importante**
Se la policy del bucket impedisce il caricamento di oggetti in questo bucket senza tag, metadati o assegnatari della lista di controllo degli accessi (ACL), non sarai in grado di creare una cartella utilizzando questa configurazione. Si dovrà invece caricare una cartella vuota e specificare queste impostazioni nella configurazione di caricamento.
**Come creare una cartella**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione sinistro, scegli **Bucket per uso generico**.
1. Nell’elenco dei bucket scegli il nome del bucket in cui desideri creare una cartella.
1. Nella scheda **Oggetti**, scegli **Crea cartella**.
1. Immettere un nome per la cartella (ad esempio, **favorite-pics**).
**Nota**
I nomi delle cartelle sono soggetti a determinate limitazioni e linee guida e sono considerati parte del nome di chiave dell’oggetto, che è limitato a 1.024 byte. Per ulteriori informazioni, consulta [Denominazione di oggetti Amazon S3](object-keys.md).
1. (Facoltativo) Se la policy di bucket richiede che gli oggetti siano crittografati con una chiave di crittografia specifica, in **Crittografia lato server**, è necessario scegliere **Specifica una chiave di crittografia** e specificare la stessa chiave di crittografia quando crei una cartella. In caso contrario, la creazione della cartella avrà esito negativo.
1. Scegliere **Create folder (Crea cartella)**.
## Creazione di cartelle pubbliche
Consigliamo di bloccare tutto l'accesso pubblico alle cartelle e ai bucket Amazon S3 a meno che non siano necessari una cartella o un bucket pubblici. Quando si rende pubblica una cartella, chiunque su Internet può visualizzare tutti gli oggetti raggruppati nella cartella.
Nella console di Amazon S3 puoi rendere pubblica una cartella. Una cartella può anche essere resa pubblica creando una policy di bucket che ne limita l'accesso ai dati in base al prefisso. Per ulteriori informazioni, consulta [Identity and Access Management per Amazon S3](security-iam.md).
**avvertimento**
Dopo aver reso pubblica una cartella nella console di Amazon S3 non è possibile renderla nuovamente privata. È necessario invece impostare le autorizzazioni per ogni singolo oggetto nella cartella pubblica affinché gli oggetti non abbiano accesso pubblico. Per ulteriori informazioni, consulta [Configurazione ACLs](managing-acls.md).
**Topics**
+ [Creazione di una cartella](#create-folder)
+ [Creazione di cartelle pubbliche](#public-folders)
+ [Calcolo delle dimensioni delle cartelle](#calculate-folder)
+ [Eliminazione di cartelle](#delete-folders)
## Calcolo delle dimensioni delle cartelle
Questa sezione spiega come utilizzare la console di Amazon S3 per calcolare le dimensioni di una cartella.
**Calcolo delle dimensioni di una cartella**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione sinistro, scegli **Bucket per uso generico**.
1. Nell’elenco **Bucket per uso generico**, scegli il nome del bucket in cui è archiviata la cartella.
1. Nell’elenco **Oggetti**, seleziona la casella di controllo accanto al nome della cartella.
1. Scegli **Actions** (Azioni), quindi scegli **Calculate total size** (Calcola dimensione totale).
**Nota**
Le informazioni sulla cartella (inclusa la dimensione totale) non sono più disponibili una volta usciti dalla pagina. È necessario calcolare nuovamente la dimensione totale se si desidera vederla di nuovo.
**Importante**
Quando utilizzi l'azione **Calculate total size** (Calcola dimensione totale) su oggetti o cartelle specificati all'interno del bucket, Amazon S3 calcola il numero totale di oggetti e la dimensione totale dello spazio di archiviazione. Tuttavia, i caricamenti in più parti incompleti o in corso e le versioni precedenti o non correnti non vengono considerati nel calcolo del numero totale di oggetti o della dimensione totale. Questa azione calcola solo il numero totale di oggetti e la dimensione totale per la versione corrente o più recente di ogni oggetto archiviato nel bucket.
Ad esempio, se nel bucket sono presenti due versioni di un oggetto, il calcolatore dello spazio di archiviazione in Amazon S3 le considera un unico oggetto. Di conseguenza, il numero totale di oggetti calcolato nella console Amazon S3 può differire dalla metrica **Object Count** mostrata in S3 Storage Lens e dal numero riportato dalla metrica Amazon,. CloudWatch `NumberOfObjects` Allo stesso modo, la dimensione totale dello storage può anche differire dalla metrica **Total Storage** mostrata in S3 Storage Lens e dalla metrica mostrata in. `BucketSizeBytes` CloudWatch
## Eliminazione di cartelle
In questa sezione viene descritto come utilizzare la console di Amazon S3 per eliminare cartelle da un bucket S3.
Per informazioni sulle funzionalità e sui prezzi di Amazon S3, consulta [Amazon S3](https://aws.amazon.com/s3/).
**Per eliminare cartelle da un bucket S3**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione sinistro, scegli **Bucket per uso generico**.
1. Nell’elenco **Bucket per uso generico** scegli il nome del bucket da cui desideri eliminare cartelle.
1. Nell’elenco **Oggetti**, seleziona la casella di controllo accanto alle cartelle e agli oggetti che desideri eliminare.
1. Scegli **Elimina**.
1. Nella pagina **Elimina oggetti** verifica che siano elencati i nomi delle cartelle selezionate per l’eliminazione in **Oggetti specificati**.
1. Nella casella **Elimina oggetti**, immetti **delete** e scegli **Elimina oggetti**.
**avvertimento**
Questa azione elimina tutti gli oggetti specificati. Quando si eliminano le cartelle, attendere che l'azione di eliminazione finisca prima di aggiungere nuovi oggetti alla cartella. In caso contrario, potrebbero essere eliminati anche nuovi oggetti.
# Visualizzazione delle proprietà di un oggetto nella console di Amazon S3
Puoi utilizzare la console di Amazon S3 per visualizzare le proprietà di un oggetto, tra cui classe di storage, impostazioni di crittografia, tag e metadati.
**Per visualizzare le proprietà di un oggetto**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione a sinistra, scegli **Bucket per uso generico** o **Bucket di directory**.
1. Nell’elenco dei bucket scegli il nome del bucket contenente l’oggetto.
1. Nell'elenco **Oggetti**, scegli il nome dell'oggetto del quale desideri visualizzare le proprietà.
Viene visualizzata la **Panoramica dell'oggetto**. È possibile scorrere verso il basso per visualizzare le proprietà dell'oggetto.
1. Nella pagina **Panoramica dell’oggetto** è possibile visualizzare o configurare le proprietà dell’oggetto indicate di seguito.
**Nota**
Se modifichi una delle proprietà **Classe di storage**, **Crittografia** o **Metadati**, viene creato un nuovo oggetto per sostituire quello precedente. Se è abilitata la funzione Controllo delle versioni S3, viene creata una nuova versione dell'oggetto e l'oggetto esistente diventa una versione precedente. Il ruolo che modifica la proprietà diventa anche il proprietario del nuovo oggetto o della versione dell'oggetto.
Se si modificano le proprietà **Classe di archiviazione**, **Crittografia** o **Metadati** di un oggetto con tag definiti dall’utente, è necessario disporre dell’autorizzazione `s3:GetObjectTagging`. Se si modificano queste proprietà per un oggetto che non ha tag definiti dall'utente ma ha una dimensione superiore a 16 MB, è necessario disporre dell'autorizzazione `s3:GetObjectTagging`.
Se la policy del bucket di destinazione nega l'azione `s3:GetObjectTagging`, le proprietà dell'oggetto verranno aggiornate, ma i tag definiti dall'utente verranno rimossi dall'oggetto e si riceverà un errore.
1. **Storage class (Classe di storage)**: a ogni oggetto in Amazon S3 è associata una classe di storage. La classe di storage che si sceglie di utilizzare dipende dalla frequenza con cui si accede all'oggetto. La classe di archiviazione predefinita per gli oggetti S3 nei bucket per uso generico è STANDARD. La classe di archiviazione predefinita per gli oggetti S3 nei bucket di directory è S3 Express One Zone. È possibile scegliere la classe di storage quando si carica un oggetto. Per ulteriori informazioni sulle classi di storage, consulta [Comprensione e gestione delle classi di storage Amazon S3](storage-class-intro.md).
Per cambiare la classe di archiviazione dopo avere caricato un oggetto in un bucket per uso generico, scegli **Classe di archiviazione**. Scegliere la classe desiderata, quindi selezionare **Save (Salva)**.
**Nota**
La classe di archiviazione degli oggetti in un bucket di directory non può essere modificata.
1. **Impostazioni di crittografia lato server**: è possibile utilizzare la crittografia lato server per crittografare gli oggetti S3. Per ulteriori informazioni, consulta le sezioni [Specificare la crittografia lato server con AWS KMS (SSE-KMS)](specifying-kms-encryption.md) o [Specifica della crittografia lato server con chiavi gestite da Amazon S3 (SSE-S3)](specifying-s3-encryption.md).
1. **Metadata (Metadati)**: ciascun oggetto in Amazon S3 dispone di un set di coppie nome-valore che ne rappresenta i metadati. Per informazioni sull'aggiunta di metadati a un oggetto di S3, consulta [Modifica dei metadati degli oggetti nella console di Amazon S3](add-object-metadata.md).
1. **Tag**: è possibile classificare l’archiviazione aggiungendo tag a un oggetto S3 in un bucket per uso generico. Per ulteriori informazioni, consulta [Classificazione degli oggetti utilizzando i tag](object-tagging.md).
1. **Blocco legale e conservazione di Object Lock**: è possibile impedire l’eliminazione di un oggetto in bucket per uso generico. Per ulteriori informazioni, consulta [Blocco di oggetti con Object Lock](object-lock.md).
# Classificazione degli oggetti utilizzando i tag
Utilizza il tagging degli oggetti per catalogare lo storage. Ogni tag è una coppia chiave-valore.
È possibile aggiungere tag ai nuovi oggetti durante il caricamento oppure è possibile aggiungerli agli oggetti esistenti.
+ È possibile associare fino a un massimo di 10 tag a ciascun oggetto. I tag associati a un oggetto devono avere chiavi di tag univoche.
+ Una chiave di tag può contenere fino a 128 caratteri Unicode e i valori dei tag possono contenere fino a 256 caratteri Unicode. I tag di oggetti Amazon S3 sono rappresentati internamente in UTF-16. I caratteri in UTF-16 usano 1 o 2 posizioni.
+ La chiave e i valori fanno distinzione tra maiuscole e minuscole.
+ Per ulteriori informazioni sulle restrizioni dei tag, consulta [Restrizioni dei tag definite dall'utente](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html#allocation-tag-restrictions) nella *Guida all'utente per la fatturazione e la gestione dei costi di AWS *. Per le restrizioni di base dei tag, consulta [Restrizioni dei tag](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions) nella *Guida all'utente di Amazon EC2*.
**Esempi**
Considerare i seguenti esempi di tagging:
**Example Informazioni PHI**
Supponiamo che un oggetto contenga dati sanitari protetti (PHI). È possibile assegnare un tag all'oggetto utilizzando la seguente coppia chiave-valore.
```
PHI=True
```
oppure
```
Classification=PHI
```
**Example File di progetto**
Supponiamo di archiviare i file di progetto nel bucket S3. È possibile assegnare un tag a questi oggetti mediante una chiave denominata `Project` e un valore, come illustrato di seguito.
```
Project=Blue
```
**Example Tag multipli**
È possibile aggiungere più tag a un oggetto, come illustrato di seguito.
```
Project=x
Classification=confidential
```
**Prefissi e tag dei nomi delle chiavi**
I prefissi dei nomi di una chiave dell'oggetto ti permettono anche di categorizzare lo storage. Tuttavia, la categorizzazione basata sui prefissi è monodimensionale. Consideriamo i seguenti nomi delle chiavi degli oggetti:
```
photos/photo1.jpg
project/projectx/document.pdf
project/projecty/document2.pdf
```
Questi nomi di chiavi hanno il prefisso `photos/`, `project/projectx/` e `project/projecty/`. Questi prefissi consentono la categorizzazione monodimensionale, ossia: tutti gli elementi sotto un prefisso costituiscono una categoria. Ad esempio, il prefisso `project/projectx` identifica tutti i documenti relativi al progetto x.
Il tagging rende disponibile un'altra dimensione. Se si desidera che photo1 sia nella categoria project x, è possibile assegnare un tag all'oggetto di conseguenza.
**Altri vantaggi**
Oltre alla classificazione dei dati, il tagging offre vantaggi quali i seguenti:
+ I tag degli oggetti consentono un controllo degli accessi granulare per le autorizzazioni. Ad esempio, è possibile concedere a un utente le autorizzazioni per leggere esclusivamente gli oggetti con tag specifici.
+ I tag degli oggetti consentono una gestione granulare del ciclo di vita dell'oggetto, in cui è possibile specificare filtri basati su tag, oltre a prefissi del nome della chiave, in una regola del ciclo di vita.
+ L'utilizzo dell'analisi Amazon S3 consente di configurare filtri per raggruppare gli oggetti per l'analisi in base ai tag dell'oggetto, al prefisso del nome della chiave di accesso o in base sia al prefisso che ai tag.
+ Puoi anche personalizzare le CloudWatch metriche di Amazon per visualizzare le informazioni tramite filtri di tag specifici. Nelle seguenti sezioni sono fornite maggiori informazioni.
**Importante**
Si possono utilizzare tag per etichettare oggetti contenenti informazioni riservate (ad esempio le informazioni personali (PII) o i dati sanitari protetti (PHI)). Tuttavia, i tag non devono contenere informazioni confidenziali.
**Aggiunta di serie di tag oggetto a più oggetti Amazon S3 con una singola richiesta**
Per aggiungere set di tag a più di un oggetto Amazon S3 con una sola richiesta, puoi utilizzare le operazioni in batch S3. Fornisci alle operazioni in batch S3 un elenco di oggetti su cui operare. Le operazioni in batch S3 richiamano la rispettiva API per eseguire l'operazione specificata. Un solo processo di operazioni in batch può eseguire l'operazione specificata su miliardi di oggetti contenenti esabyte di dati.
La funzionalità Operazioni in batch S3 tiene traccia dei progressi, invia notifiche e memorizza un report dettagliato sul completamento di tutte le azioni, offrendo un'esperienza serverless completamente gestita e verificabile. Puoi utilizzare S3 Batch Operations tramite la console Amazon S3 o l' AWS CLI API AWS SDKs REST. Per ulteriori informazioni, consulta [Nozioni di base sulle operazioni in batch S3](batch-ops.md#batch-ops-basics).
Per ulteriori informazioni sui tag degli oggetti, consulta [Gestione di tag degli oggetti](tagging-managing.md).
## Operazioni API correlate al tagging oggetti
Amazon S3 supporta le seguenti operazioni API, specifiche per il tagging oggetti:
**Operazioni delle API sugli oggetti**
+ [PUT Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTtagging.html) – Sostituisce i tag su un oggetto. È possibile specificare i tag nel corpo della richiesta. La gestione di tag degli oggetti mediante queste API prevede due scenari distinti.
+ L'oggetto non ha tag – Mediante questa API, è possibile aggiungere un set di tag a un oggetto (l'oggetto non ha tag precedenti).
+ L'oggetto ha un set tag esistenti – Per modificare il set di tag esistenti, è necessario prima recuperarlo, modificarlo sul lato client, quindi utilizzare questa API per sostituire il set di tag.
**Nota**
Se si invia questa richiesta con un set di tag vuoto, Amazon S3 elimina il set di tag esistenti sull'oggetto. Se si usa questo metodo, verrà addebitata una richiesta Tier 1 (PUT). Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://d0.awsstatic.com/whitepapers/aws_pricing_overview.pdf).
La richiesta [DELETE Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETEtagging.html) è preferibile perché fornisce lo stesso risultato senza nessun addebito.
+ [GET Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html) – Restituisce il set di tag associato a un oggetto. Amazon S3 restituisce i tag degli oggetti nel corpo della risposta.
+ [DELETE Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETEtagging.html) – Elimina il set di tag associato a un oggetto.
**Altre operazioni API che supportano il tagging**
+ [PUT Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) e [Initiate Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html) – È possibile specificare i tag quando si creano oggetti. I tag possono essere specificati utilizzando l'intestazione di richiesta `x-amz-tagging`.
+ [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) – Anziché restituire il set di tag, Amazon S3 restituisce il conteggio dei tag degli oggetti nell'intestazione di `x-amz-tag-count` (solo se il richiedente dispone delle autorizzazioni per leggere i tag) poiché le dimensioni della risposta nell'intestazione sono limitate a 8 K di byte. Se si desidera visualizzare i tag, fare un'altra richiesta di operazione API [GET Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html).
+ [POST Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html) – È possibile specificare tag nella richiesta POST.
È possibile utilizzare l'API `PUT Object ` per creare oggetti con tag, purché i tag della richiesta non superino le dimensioni massime dell'intestazione della richiesta HTTP di 8 Kbyte, Se i tag specificati superano le dimensioni massime dell'intestazione, è possibile utilizzare questo metodo POST che consiste nell'includere i tag nel corpo.
[PUT Object - Copy](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectCOPY.html) – È possibile specificare `x-amz-tagging-directive` nella richiesta per indicare ad Amazon S3 di copiare (comportamento di default) i tag o sostituirli mediante un nuovo set di tag fornito nella richiesta.
Tieni presente quanto segue:
+ Il tagging degli oggetti S3 è molto coerente. Per ulteriori informazioni, consulta [Modello di consistenza dati Amazon S3](Welcome.md#ConsistencyModel).
## Configurazioni aggiuntive
In questa sezione viene descritto in che modo il tagging oggetti è correlato alle altre configurazioni.
### Tagging oggetti e gestione del ciclo di vita
In una configurazione del ciclo di vita del bucket, è possibile specificare un filtro per selezionare un sottoinsieme di oggetti a cui si applica la regola. È possibile specificare un filtro in base ai prefissi dei nomi delle chiavi, ai tag degli oggetti o entrambi.
Supponiamo di archiviare foto (in formato raw e in formato finito) nel bucket Amazon S3. A questi oggetti possono essere assegnati tag nel modo seguente.
```
phototype=raw
or
phototype=finished
```
È possibile archiviare le foto non elaborate in Amazon Glacier poco dopo la creazione. È possibile configurare una regola del ciclo di vita con un filtro che identifica il sottoinsieme di oggetti con prefisso del nome della chiave (`photos/`) aventi un tag specifico (`phototype=raw`).
Per ulteriori informazioni, consulta [Gestione del ciclo di vita degli oggetti](object-lifecycle-mgmt.md).
### Tagging degli oggetti e replica
Se è stata configurata la replica nel bucket, Amazon S3 replica i tag, purché ad Amazon S3 siano assegnate le autorizzazioni per leggerli. Per ulteriori informazioni, consulta [Panoramica della configurazione della replica in tempo reale](replication-how-setup.md).
### Notifiche eventi di assegnazione tag su oggetti
Puoi configurare una notifica eventi Amazon S3 per ricevere una notifica quando viene aggiunto o eliminato un tag oggetto da un oggetto. Il tipo di evento `s3:ObjectTagging:Put` ti avvisa quando un tag viene INSERITO su un oggetto o quando viene aggiornato un tag esistente. Il tipo di evento `s3:ObjectTagging:Delete` ti avvisa quando un tag viene rimosso da un oggetto. Per ulteriori informazioni, consulta [ Abilitazione notifiche eventi](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-enable-disable-notification-intro.html).
Per ulteriori informazioni sul tagging degli oggetti, consulta i seguenti argomenti:
**Topics**
+ [Operazioni API correlate al tagging oggetti](#tagging-apis)
+ [Configurazioni aggiuntive](#tagging-other-configs)
+ [Tagging e policy di controllo degli accessi](tagging-and-policies.md)
+ [Gestione di tag degli oggetti](tagging-managing.md)
# Tagging e policy di controllo degli accessi
Le policy di autorizzazione (policy bucket e policy utente) possono essere utilizzate per gestire le autorizzazioni relative al tagging oggetti. Per le operazioni delle policy, consulta i seguenti argomenti:
+ [Operazioni con gli oggetti](security_iam_service-with-iam.md#using-with-s3-actions-related-to-objects)
+ [Operazioni relative ai bucket](security_iam_service-with-iam.md#using-with-s3-actions-related-to-buckets)
I tag degli oggetti consentono un controllo degli accessi granulare per la gestione delle autorizzazioni. È possibile concedere autorizzazioni condizionali in base ai tag degli oggetti. Amazon S3 supporta le seguenti chiavi di condizione che è possibile utilizzare per concedere autorizzazioni condizionali basate sui tag degli oggetti.
+ `s3:ExistingObjectTag/` – Utilizzare questa chiave di condizione per verificare che un tag degli oggetti esistente abbia una chiave e un valore di tag specifici.
**Nota**
Quando si concedono autorizzazioni per le operazioni `PUT Object` e `DELETE Object`, questa chiave di condizione non è supportata. Ciò significa che non è possibile creare una policy per concedere o rifiutare le autorizzazioni utente che consentono di eliminare o sovrascrivere un oggetto in base ai relativi tag esistenti.
+ `s3:RequestObjectTagKeys` – Utilizzare questa chiave di condizione per limitare le chiavi di tag che si desidera consentire sugli oggetti. Ciò è utile quando si aggiungono tag agli oggetti utilizzando le richieste PutObjectTagging di oggetti and e POST. PutObject
+ `s3:RequestObjectTag/` – Utilizzare questa chiave di condizione per limitare i valori e le chiavi di tag che si desidera consentire sugli oggetti. Ciò è utile quando si aggiungono tag agli oggetti utilizzando le richieste PutObjectTagging and PutObject e POST Bucket.
Per un elenco completo delle chiavi di condizione specifiche per il servizio Amazon S3, consulta [Esempi di policy per i bucket che utilizzano le chiavi di condizione](amazon-s3-policy-keys.md). Le seguenti policy di autorizzazione illustrano il modo in cui il tagging oggetti consente una gestione granulare delle autorizzazioni di accesso.
**Example 1: concedere a un utente autorizzazioni di sola lettura per gli oggetti con un valore di tag o chiave specifico**
La seguente policy di autorizzazione limita l'utente a leggere solo gli oggetti che hanno il tag chiave e il valore `environment: production`. Questa policy utilizza la chiave di condizione `s3:ExistingObjectTag` per specificare la chiave e il valore del tag.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:role/JohnDoe"
]
},
"Effect": "Allow",
"Action": ["s3:GetObject", "s3:GetObjectVersion"],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Condition": {
"StringEquals":
{"s3:ExistingObjectTag/environment": "production"}
}
}
]
}
```
**Example 2: limitare le chiavi di tag dell'oggetto che gli utenti possono aggiungere**
La seguente policy di autorizzazione concede a un utente le autorizzazioni per eseguire l'operazione `s3:PutObjectTagging`, che permette di aggiungere tag a un oggetto esistente. La condizione utilizza la chiave di condizione `s3:RequestObjectTagKeys` per specificare le chiavi di tag consentite, ad esempio `Owner` o `CreationDate`. Per ulteriori informazioni, consulta la sezione [Creazione di una condizione con più chiavi o valori](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_multi-value-conditions.html) nella *Guida per l'utente IAM*.
La policy garantisce che ogni chiave di tag specificata nella richiesta sia una chiave di tag autorizzata. Il qualificatore `ForAnyValue` nella condizione garantisce che almeno una delle chiavi specificate sia presente nella richiesta.
****
```
{
"Version":"2012-10-17",
"Statement": [
{"Principal":{"AWS":[
"arn:aws:iam::111122223333:role/JohnDoe"
]
},
"Effect": "Allow",
"Action": [
"s3:PutObjectTagging"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
],
"Condition": {"ForAnyValue:StringEquals": {"s3:RequestObjectTagKeys": [
"Owner",
"CreationDate"
]
}
}
}
]
}
```
**Example 3: richiedere una chiave e un valore di tag specifici per consentire agli utenti di aggiungere tag di oggetti**
Il seguente esempio di policy concede a un utente l'autorizzazione a eseguire l'azione `s3:PutObjectTagging`, che consente di aggiungere tag a un oggetto esistente. La condizione prevede che l'utente includa una chiave di tag specifica (ad esempio, `Project`) con valore impostato su `X`.
****
```
{
"Version":"2012-10-17",
"Statement": [
{"Principal":{"AWS":[
"arn:aws:iam::111122223333:user/JohnDoe"
]
},
"Effect": "Allow",
"Action": [
"s3:PutObjectTagging"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
],
"Condition": {"StringEquals": {"s3:RequestObjectTag/Project": "X"
}
}
}
]
}
```
# Gestione di tag degli oggetti
Questa sezione spiega come gestire i tag degli oggetti utilizzando la console AWS SDKs per Java e.NET o Amazon S3.
Il tagging degli oggetti consente di classificare l’archiviazione in bucket per uso generico. Ciascun tag è una coppia chiave-valore che aderisce alle seguenti regole:
+ Puoi associare fino a 10 tag a un oggetto. I tag associati a un oggetto devono avere chiavi di tag univoche.
+ Una chiave tag può contenere fino a 128 caratteri Unicode e i valori dei tag possono contenere fino a 256 caratteri Unicode. I tag di oggetti Amazon S3 sono rappresentati internamente in UTF-16. I caratteri in UTF-16 usano 1 o 2 posizioni.
+ La chiave e i valori fanno distinzione tra maiuscole e minuscole.
Per ulteriori informazioni sui tag degli oggetti, consulta [Classificazione degli oggetti utilizzando i tag](object-tagging.md). Per ulteriori informazioni sui limiti dei tag, consulta [Restrizioni sui tag definiti dall'utente](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html) nella *Guida per l'utente Gestione dei costi e fatturazione AWS *.
## Utilizzo della console S3
**Per aggiungere tag a un oggetto**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione sinistro, scegli **Bucket per uso generico**.
1. Nell’elenco dei bucket scegli il nome del bucket contenente l’oggetto.
1. Seleziona la casella di controllo a sinistra dei nomi degli oggetti da modificare.
1. Dal menu **Operazioni**, seleziona **Modifica tag**.
1. Esamina gli oggetti elencati e seleziona **Aggiungi tag**.
1. Ogni tag oggetto è una coppia chiave-valore. Immettere una **chiave** e un **valore**. Per aggiungere un altro tag, scegliere **Add Tag (Aggiungi tag)**.
È possibile immettere fino a un massimo di 10 tag per ciascun oggetto.
1. Seleziona **Salva modifiche**.
Amazon S3 aggiungerà i tag agli oggetti specificati.
Per ulteriori informazioni, vedi anche [Visualizzazione delle proprietà di un oggetto nella console di Amazon S3](view-object-properties.md) e [Caricamento degli oggetti](upload-objects.md) in questa guida.
## Usando il AWS SDKs
------
#### [ Java ]
Per gestire i tag degli oggetti utilizzando l' AWS SDK for Java, puoi impostare i tag per un nuovo oggetto e recuperare o sostituire i tag per un oggetto esistente. Per ulteriori informazioni sul tagging dell'oggetto, consulta [Classificazione degli oggetti utilizzando i tag](object-tagging.md).
Caricare un oggetto in un bucket e impostare tag mediante un’interfaccia S3Client. Per esempi, consulta [Caricamento di un oggetto in un bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObject_section.html) nella *Guida di riferimento delle API di Amazon S3*.
------
#### [ .NET ]
L'esempio seguente mostra come utilizzare AWS SDK per .NET per impostare i tag per un nuovo oggetto e recuperare o sostituire i tag per un oggetto esistente. Per ulteriori informazioni sul tagging dell'oggetto, consulta [Classificazione degli oggetti utilizzando i tag](object-tagging.md).
Per informazioni sulla configurazione e l'esecuzione degli esempi di codice, consulta [Getting Started with the AWS SDK for .NET nella AWS SDK for](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) .NET *Developer Guide*.
```
using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
namespace Amazon.DocSamples.S3
{
public class ObjectTagsTest
{
private const string bucketName = "*** bucket name ***";
private const string keyName = "*** key name for the new object ***";
private const string filePath = @"*** file path ***";
// Specify your bucket region (an example region is shown).
private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2;
private static IAmazonS3 client;
public static void Main()
{
client = new AmazonS3Client(bucketRegion);
PutObjectWithTagsTestAsync().Wait();
}
static async Task PutObjectWithTagsTestAsync()
{
try
{
// 1. Put an object with tags.
var putRequest = new PutObjectRequest
{
BucketName = bucketName,
Key = keyName,
FilePath = filePath,
TagSet = new List{
new Tag { Key = "Keyx1", Value = "Value1"},
new Tag { Key = "Keyx2", Value = "Value2" }
}
};
PutObjectResponse response = await client.PutObjectAsync(putRequest);
// 2. Retrieve the object's tags.
GetObjectTaggingRequest getTagsRequest = new GetObjectTaggingRequest
{
BucketName = bucketName,
Key = keyName
};
GetObjectTaggingResponse objectTags = await client.GetObjectTaggingAsync(getTagsRequest);
for (int i = 0; i < objectTags.Tagging.Count; i++)
Console.WriteLine("Key: {0}, Value: {1}", objectTags.Tagging[i].Key, objectTags.Tagging[i].Value);
// 3. Replace the tagset.
Tagging newTagSet = new Tagging();
newTagSet.TagSet = new List{
new Tag { Key = "Key3", Value = "Value3"},
new Tag { Key = "Key4", Value = "Value4" }
};
PutObjectTaggingRequest putObjTagsRequest = new PutObjectTaggingRequest()
{
BucketName = bucketName,
Key = keyName,
Tagging = newTagSet
};
PutObjectTaggingResponse response2 = await client.PutObjectTaggingAsync(putObjTagsRequest);
// 4. Retrieve the object's tags.
GetObjectTaggingRequest getTagsRequest2 = new GetObjectTaggingRequest();
getTagsRequest2.BucketName = bucketName;
getTagsRequest2.Key = keyName;
GetObjectTaggingResponse objectTags2 = await client.GetObjectTaggingAsync(getTagsRequest2);
for (int i = 0; i < objectTags2.Tagging.Count; i++)
Console.WriteLine("Key: {0}, Value: {1}", objectTags2.Tagging[i].Key, objectTags2.Tagging[i].Value);
}
catch (AmazonS3Exception e)
{
Console.WriteLine(
"Error encountered ***. Message:'{0}' when writing an object"
, e.Message);
}
catch (Exception e)
{
Console.WriteLine(
"Encountered an error. Message:'{0}' when writing an object"
, e.Message);
}
}
}
}
```
------