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à.
# Gestione delle annotazioni
Puoi aggiungere, recuperare ed eliminare annotazioni sui tuoi oggetti Amazon S3 utilizzando AWS CLI, o AWS Management Console SDK. AWS Le seguenti sezioni descrivono come eseguire ciascuna operazione.
## Aggiungere o aggiornare un'annotazione
È possibile aggiungere una nuova annotazione a un oggetto o aggiornare un'annotazione esistente sostituendone il payload.
### Utilizzo della console S3
**Per aggiungere un'annotazione a un oggetto**
1. Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nell'elenco **Buckets (Bucket)** scegliere il nome del bucket contenente l'oggetto.
1. Nell'elenco **Oggetti**, scegli il nome dell'oggetto che desideri annotare.
1. Scegliere la scheda **Properties (Proprietà)**.
1. Scorri fino alla sezione **Annotazioni e scegli **Aggiungi** annotazione**.
1. Per **Nome**, inserisci un nome per l'annotazione (ad esempio,). `ml.sentiment` I nomi devono contenere da 1 a 512 byte e possono contenere lettere, cifre, caratteri di sottolineatura, punti e trattini Unicode. I `aws` nomi non possono iniziare con o. `s3`
1. **Scegli il file** per caricare il contenuto dell'annotazione. Il file deve essere UTF-8 codificabile e avere una dimensione massima di 1 MB.
**Per completare l'annotazione**
1. (Facoltativo) In **Checksum**, scegliete un algoritmo di checksum.
1. **Scegli Aggiungi annotazione.**
**Nota**
Per visualizzare il contenuto di un'annotazione dopo la sua creazione, è necessario scaricare l'annotazione. La console S3 non visualizza il contenuto delle annotazioni in linea.
### Utilizzo di AWS CLI
Per aggiungere o aggiornare un'annotazione su un oggetto, usa il comando. `put-object-annotation` Il `--annotation-payload` parametro accetta un percorso di file.
```
aws s3api put-object-annotation \
--bucket amzn-s3-demo-bucket \
--key myDocument.pdf \
--annotation-name "ml.sentiment" \
--annotation-payload /tmp/sentiment.json
```
Per scrivere l'annotazione solo se l'oggetto non è stato sovrascritto dall'ultima volta che l'hai letto, specifica il `--object-if-match` parametro con l'ETag corrente dell'oggetto.
```
aws s3api put-object-annotation \
--bucket amzn-s3-demo-bucket \
--key myDocument.pdf \
--annotation-name "ml.sentiment" \
--annotation-payload /tmp/sentiment.json \
--object-if-match "\"d6eb32081c822ed572b70567826d9d9d\""
```
### Utilizzo di AWS SDK
L'esempio seguente utilizza l' AWS SDK for Python (Boto3) per aggiungere un'annotazione a un oggetto.
```
import boto3
import json
s3 = boto3.client('s3')
s3.put_object_annotation(
Bucket='amzn-s3-demo-bucket',
Key='myDocument.pdf',
AnnotationName='ml.sentiment',
AnnotationPayload=json.dumps({
'score': 0.95,
'label': 'positive',
'model': 'sentiment-v3'
}).encode('utf-8')
)
```
## Recupero delle annotazioni
È possibile recuperare un'annotazione specifica o elencare tutte le annotazioni su un oggetto.
### Utilizzo della console S3
**Per recuperare un'annotazione**
1. Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nell'elenco **Buckets (Bucket)** scegliere il nome del bucket contenente l'oggetto.
1. Nell'elenco **Oggetti** scegliere il nome dell'oggetto.
1. Scegli la scheda **Proprietà** e scorri fino alla sezione **Annotazioni.**
1. Per visualizzare il contenuto dell'annotazione, scegli **Scarica** accanto al nome dell'annotazione.
### Utilizzo di AWS CLI
Per recuperare un'annotazione specifica, usa il comando. `get-object-annotation`
```
aws s3api get-object-annotation \
--bucket amzn-s3-demo-bucket \
--key myDocument.pdf \
--annotation-name "ml.sentiment" \
output.json
```
Per elencare tutte le annotazioni su un oggetto, usa il comando. `list-object-annotations`
```
aws s3api list-object-annotations \
--bucket amzn-s3-demo-bucket \
--key myDocument.pdf
```
### Utilizzo di AWS SDK
L'esempio seguente utilizza l' AWS SDK for Python (Boto3) per recuperare ed elencare le annotazioni.
```
import boto3
import json
s3 = boto3.client('s3')
# Retrieve a specific annotation
response = s3.get_object_annotation(
Bucket='amzn-s3-demo-bucket',
Key='myDocument.pdf',
AnnotationName='ml.sentiment'
)
content = json.loads(response['AnnotationPayload'].read())
# List all annotations on an object
response = s3.list_object_annotations(
Bucket='amzn-s3-demo-bucket',
Key='myDocument.pdf'
)
for annotation in response['Annotations']:
print(f"{annotation['AnnotationName']} - {annotation['Size']} bytes")
```
## Eliminazione delle annotazioni
È possibile eliminare un'annotazione specifica da un oggetto. L'eliminazione delle annotazioni è permanente e non può essere annullata.
### Utilizzo della console S3
**Per eliminare un'annotazione**
1. Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nell'elenco **Buckets (Bucket)** scegliere il nome del bucket contenente l'oggetto.
1. Nell'elenco **Oggetti** scegliere il nome dell'oggetto.
1. Scegli la scheda **Proprietà** e scorri fino alla sezione **Annotazioni.**
1. Seleziona l'annotazione che desideri eliminare.
1. Scegliete **Elimina**, quindi confermate l'eliminazione.
### Utilizzo di AWS CLI
Per eliminare un'annotazione specifica, usa il `delete-object-annotation` comando.
```
aws s3api delete-object-annotation \
--bucket amzn-s3-demo-bucket \
--key myDocument.pdf \
--annotation-name "ml.sentiment"
```
### Utilizzo di AWS SDK
L'esempio seguente utilizza l' AWS SDK for Python (Boto3) per eliminare un'annotazione.
```
import boto3
s3 = boto3.client('s3')
s3.delete_object_annotation(
Bucket='amzn-s3-demo-bucket',
Key='myDocument.pdf',
AnnotationName='ml.sentiment'
)
```