

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 développement logiciel (SDK) ou des Console de gestion AWS kits de 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 Console de gestion AWS et ouvrez la console Amazon S3 à 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 ** le ** champ Nom, entrez le nom de l'annotation (par exemple,`ml.sentiment`). Les noms doivent comporter 1 à 512 octets et peuvent contenir des lettres Unicode, des chiffres, des traits de soulignement, des points et des tirets. 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 ** Sommes de contrôle**, choisissez un algorithme de somme de contrôle.

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 la 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) pour ajouter une annotation à un objet.

```python
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 Console de gestion AWS et ouvrez la console Amazon S3 à 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.

```python
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 définitive 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 Console de gestion AWS et ouvrez la console Amazon S3 à 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.

```python
import boto3

s3 = boto3.client('s3')

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