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
<a name="annotations-managing"></a>

Puoi aggiungere, recuperare ed eliminare annotazioni sui tuoi oggetti Amazon S3 utilizzando gli SDK,, o. Console di gestione AWS AWS CLI AWS Le seguenti sezioni descrivono come eseguire ciascuna operazione.

## Aggiungere o aggiornare un'annotazione
<a name="annotations-managing-add"></a>

È possibile aggiungere una nuova annotazione a un oggetto o aggiornare un'annotazione esistente sostituendone il payload.

### Utilizzo della console S3
<a name="annotations-managing-add-console"></a>

**Per aggiungere un'annotazione a un oggetto**

1. Accedi 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. 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**, inserite un nome per l'annotazione (ad esempio,). `ml.sentiment` I nomi devono contenere da 1 a 512 byte e possono contenere lettere Unicode, cifre, caratteri di sottolineatura, punti e trattini. I `aws` nomi non possono iniziare con o. `s3`

1. Scegli ** Scegli 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**, scegli un algoritmo di checksum.

1. Scegli Aggiungi ** annotazione. **

**Nota**  
Per visualizzare il contenuto di un'annotazione dopo la sua creazione, è necessario scaricarla. La console S3 non visualizza il contenuto delle annotazioni in linea.

### Utilizzo di AWS CLI
<a name="annotations-managing-add-cli"></a>

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'avete letto, specificate 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
<a name="annotations-managing-add-sdk"></a>

L'esempio seguente utilizza l' AWS SDK per 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
<a name="annotations-managing-get"></a>

È possibile recuperare un'annotazione specifica o elencare tutte le annotazioni su un oggetto.

### Utilizzo della console S3
<a name="annotations-managing-get-console"></a>

**Per recuperare un'annotazione**

1. Accedi 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. 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 delle annotazioni, scegli ** Scarica ** accanto al nome dell'annotazione.

### Utilizzo di AWS CLI
<a name="annotations-managing-get-cli"></a>

Per recuperare un'annotazione specifica, utilizzate 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, usate il comando. `list-object-annotations`

```
aws s3api list-object-annotations \
    --bucket amzn-s3-demo-bucket \
    --key myDocument.pdf
```

### Utilizzo di AWS SDK
<a name="annotations-managing-get-sdk"></a>

L'esempio seguente utilizza l' AWS SDK per 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
<a name="annotations-managing-delete"></a>

È possibile eliminare un'annotazione specifica da un oggetto. L'eliminazione delle annotazioni è permanente e non può essere annullata.

### Utilizzo della console S3
<a name="annotations-managing-delete-console"></a>

**Per eliminare un'annotazione**

1. Accedi 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. 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. Scegli ** Elimina**, quindi conferma l'eliminazione.

### Utilizzo di AWS CLI
<a name="annotations-managing-delete-cli"></a>

Per eliminare un'annotazione specifica, utilizzate 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
<a name="annotations-managing-delete-sdk"></a>

L'esempio seguente utilizza l' AWS SDK per 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'
)
```