Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des annotations

Vous pouvez ajouter, récupérer et supprimer des annotations sur vos objets Amazon S3 à l'aide des kits de AWS Management Console AWS développement logiciel (SDK). AWS CLI Les sections suivantes décrivent comment effectuer chaque opération.

Ajouter ou mettre à jour une annotation

Vous pouvez ajouter une nouvelle annotation à un objet ou mettre à jour une annotation existante en remplaçant sa charge utile.

Utilisation de la console S3

Utilisation de AWS CLI

Pour ajouter ou mettre à jour une annotation sur un objet, utilisez la put-object-annotation commande. Le --annotation-payload paramètre accepte un chemin de fichier.

aws s3api put-object-annotation \
    --bucket amzn-s3-demo-bucket \
    --key myDocument.pdf \
    --annotation-name "ml.sentiment" \
    --annotation-payload /tmp/sentiment.json

Pour écrire l'annotation uniquement si l'objet n'a pas été remplacé depuis votre dernière lecture, spécifiez le --object-if-match paramètre avec l'ETag actuel de l'objet.

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\""

Utilisation de AWS Kits SDK

L'exemple suivant utilise le AWS SDK pour Python (Boto3) afin d'ajouter une annotation à un objet.

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

Récupération d'annotations

Vous pouvez récupérer une annotation spécifique ou répertorier toutes les annotations d'un objet.

Utilisation de la console S3

Utilisation de AWS CLI

Pour récupérer une annotation spécifique, utilisez la get-object-annotation commande.

aws s3api get-object-annotation \
    --bucket amzn-s3-demo-bucket \
    --key myDocument.pdf \
    --annotation-name "ml.sentiment" \
    output.json

Pour répertorier toutes les annotations d'un objet, utilisez la list-object-annotations commande.

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

Utilisation de AWS Kits SDK

L'exemple suivant utilise le AWS SDK pour Python (Boto3) pour récupérer et répertorier les annotations.

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

Supprimer des annotations

Vous pouvez supprimer une annotation spécifique d'un objet. La suppression des annotations est permanente et ne peut pas être annulée.

Utilisation de la console S3

Utilisation de AWS CLI

Pour supprimer une annotation spécifique, utilisez la delete-object-annotation commande.

aws s3api delete-object-annotation \
    --bucket amzn-s3-demo-bucket \
    --key myDocument.pdf \
    --annotation-name "ml.sentiment"

Utilisation de AWS Kits SDK

L'exemple suivant utilise le AWS SDK pour Python (Boto3) pour supprimer une annotation.

import boto3

s3 = boto3.client('s3')

s3.delete_object_annotation(
    Bucket='amzn-s3-demo-bucket',
    Key='myDocument.pdf',
    AnnotationName='ml.sentiment'
)