Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Anmerkungen verwalten
<a name="annotations-managing"></a>

Mit den AWS SDKs, oder können Sie Anmerkungen zu Ihren Amazon S3 S3-Objekten hinzufügen AWS-Managementkonsole AWS CLI, abrufen und löschen. In den folgenden Abschnitten wird beschrieben, wie die einzelnen Operationen ausgeführt werden.

## Hinzufügen oder Aktualisieren einer Anmerkung
<a name="annotations-managing-add"></a>

Sie können einem Objekt eine neue Anmerkung hinzufügen oder eine bestehende Anmerkung aktualisieren, indem Sie die zugehörige Nutzlast ersetzen.

### Verwenden der S3-Konsole
<a name="annotations-managing-add-console"></a>

**Um einem Objekt eine Anmerkung hinzuzufügen**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Wählen Sie in der Liste **Buckets** den Namen des Buckets aus, der das Objekt enthält.

1. Wählen Sie in der **Objektliste** den Namen des Objekts aus, das Sie mit Anmerkungen versehen möchten.

1. Wählen Sie die Registerkarte **Eigenschaften** aus.

1. Scrollen Sie zum Bereich **Anmerkungen** und wählen Sie Anmerkung **hinzufügen**.

1. Geben Sie unter **Name** einen Namen für die Anmerkung ein (z. B.`ml.sentiment`). Namen müssen 1—512 Byte lang sein und können Unicode-Buchstaben, Ziffern, Unterstriche, Punkte und Bindestriche enthalten. Namen dürfen nicht mit oder beginnen. `aws` `s3`

1. Wählen Sie **Datei auswählen**, um den Inhalt der Anmerkung hochzuladen. Die Datei muss UTF-8 kodierbar sein und eine Größe von bis zu 1 MB haben.

**Um die Anmerkung zu vervollständigen**

1. (Optional) Wählen Sie unter **Prüfsummen** einen Prüfsummenalgorithmus aus.

1. Wählen Sie Anmerkung **hinzufügen** aus.

**Anmerkung**  
Um den Inhalt einer Anmerkung nach ihrer Erstellung anzuzeigen, müssen Sie die Anmerkung herunterladen. Die S3-Konsole zeigt den Inhalt von Anmerkungen nicht inline an.

### Verwendung der AWS CLI
<a name="annotations-managing-add-cli"></a>

Verwenden Sie den `put-object-annotation` Befehl, um eine Anmerkung zu einem Objekt hinzuzufügen oder zu aktualisieren. Der `--annotation-payload` Parameter akzeptiert einen Dateipfad.

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

Um die Anmerkung nur zu schreiben, wenn das Objekt seit dem letzten Lesen nicht überschrieben wurde, geben Sie den `--object-if-match` Parameter mit dem aktuellen ETag des Objekts an.

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

### Verwendung der AWS SDKs
<a name="annotations-managing-add-sdk"></a>

Im folgenden Beispiel wird das AWS SDK for Python (Boto3) verwendet, um einem Objekt eine Anmerkung hinzuzufügen.

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

## Anmerkungen werden abgerufen
<a name="annotations-managing-get"></a>

Sie können eine bestimmte Anmerkung abrufen oder alle Anmerkungen zu einem Objekt auflisten.

### Verwenden der S3-Konsole
<a name="annotations-managing-get-console"></a>

**Um eine Anmerkung abzurufen**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Wählen Sie in der Liste **Buckets** den Namen des Buckets aus, der das Objekt enthält.

1. Wählen Sie in der Liste **Objects (Objekte)** den Namen des Objekts aus.

1. Wählen Sie die Registerkarte **Eigenschaften** und scrollen Sie zum Abschnitt **Anmerkungen**.

1. Um den Inhalt der Anmerkung anzuzeigen, wählen Sie neben dem Namen der Anmerkung die Option **Herunterladen** aus.

### Verwendung der AWS CLI
<a name="annotations-managing-get-cli"></a>

Verwenden Sie den `get-object-annotation` Befehl, um eine bestimmte Anmerkung abzurufen.

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

Um alle Anmerkungen zu einem Objekt aufzulisten, verwenden Sie den `list-object-annotations` Befehl.

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

### Verwendung der AWS SDKs
<a name="annotations-managing-get-sdk"></a>

Das folgende Beispiel verwendet das AWS SDK for Python (Boto3), um Anmerkungen abzurufen und aufzulisten.

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

## Löschen von Anmerkungen
<a name="annotations-managing-delete"></a>

Sie können eine bestimmte Anmerkung aus einem Objekt löschen. Das Löschen von Anmerkungen ist dauerhaft und kann nicht rückgängig gemacht werden.

### Verwenden der S3-Konsole
<a name="annotations-managing-delete-console"></a>

**Um eine Anmerkung zu löschen**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Wählen Sie in der Liste **Buckets** den Namen des Buckets aus, der das Objekt enthält.

1. Wählen Sie in der Liste **Objects (Objekte)** den Namen des Objekts aus.

1. Wählen Sie die Registerkarte **Eigenschaften** und scrollen Sie zum Abschnitt **Anmerkungen**.

1. Wählen Sie die Anmerkung aus, die Sie löschen möchten.

1. Wählen Sie **Löschen** und bestätigen Sie den Löschvorgang.

### Verwendung der AWS CLI
<a name="annotations-managing-delete-cli"></a>

Verwenden Sie den `delete-object-annotation` Befehl, um eine bestimmte Anmerkung zu löschen.

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

### Verwendung der AWS SDKs
<a name="annotations-managing-delete-sdk"></a>

Im folgenden Beispiel wird das AWS SDK for Python (Boto3) verwendet, um eine Anmerkung zu löschen.

```
import boto3

s3 = boto3.client('s3')

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