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

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

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

Verwendung der AWS CLI

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

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

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

Verwenden der S3-Konsole

Verwendung der AWS CLI

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

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

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

Verwendung der AWS CLI

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

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