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

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

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

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'
)