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

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

## Ajouter ou mettre à jour une annotation
<a name="annotations-managing-add"></a>

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

**Pour ajouter une annotation à un objet**

1. Connectez-vous à la console Amazon S3 Console de gestion AWS et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans la liste **Compartiments**, choisissez le nom du compartiment qui contient l’objet.

1. Dans la liste **Objets**, choisissez le nom de l'objet que vous souhaitez annoter.

1. Choisissez l’onglet **Propriétés**.

1. Accédez à la section **Annotations** et choisissez **Ajouter une annotation**.

1. Dans **Nom**, entrez le nom de l'annotation (par exemple,`ml.sentiment`). Les noms doivent avoir une taille de 1 à 512 octets et peuvent contenir des lettres Unicode, des chiffres, des traits de soulignement, des points et des traits d'union. Les noms ne peuvent pas commencer par `aws` ou`s3`.

1. Choisissez **Choisir un fichier** pour télécharger le contenu de l'annotation. Le fichier doit être UTF-8 encodable et avoir une taille maximale de 1 Mo.

**Pour terminer l'annotation**

1. (Facultatif) Sous **Checksums**, choisissez un algorithme de checksum.

1. Choisissez **Ajouter une annotation**.

**Note**  
Pour afficher le contenu d'une annotation après sa création, vous devez télécharger l'annotation. La console S3 n'affiche pas le contenu des annotations en ligne.

### Utilisation de AWS CLI
<a name="annotations-managing-add-cli"></a>

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

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

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

### Utilisation de la console S3
<a name="annotations-managing-get-console"></a>

**Pour récupérer une annotation**

1. Connectez-vous à la console Amazon S3 Console de gestion AWS et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans la liste **Buckets** (Compartiments), choisissez le nom du compartiment qui contient l'objet.

1. Dans la liste **Objets**, choisissez le nom de l’objet.

1. Choisissez l'onglet **Propriétés** et accédez à la section **Annotations**.

1. Pour afficher le contenu de l'annotation, choisissez **Télécharger** à côté du nom de l'annotation.

### Utilisation de AWS CLI
<a name="annotations-managing-get-cli"></a>

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

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

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

**Pour supprimer une annotation**

1. Connectez-vous à la console Amazon S3 Console de gestion AWS et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans la liste **Buckets** (Compartiments), choisissez le nom du compartiment qui contient l'objet.

1. Dans la liste **Objets**, choisissez le nom de l’objet.

1. Choisissez l'onglet **Propriétés** et accédez à la section **Annotations**.

1. Sélectionnez l'annotation que vous souhaitez supprimer.

1. Choisissez **Supprimer**, puis confirmez la suppression.

### Utilisation de AWS CLI
<a name="annotations-managing-delete-cli"></a>

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

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