View a markdown version of this page

Mengelola anotasi - Amazon Simple Storage Service
Menambahkan atau memperbarui anotasiMengambil anotasiMenghapus anotasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengelola anotasi

Anda dapat menambahkan, mengambil, dan menghapus anotasi pada objek Amazon S3 menggunakan AWS CLI,, atau AWS Management Console SDK. AWS Bagian berikut menjelaskan cara melakukan setiap operasi.

Menambahkan atau memperbarui anotasi

Anda dapat menambahkan anotasi baru ke objek atau memperbarui anotasi yang ada dengan mengganti payloadnya.

Menggunakan konsol S3

Untuk menambahkan anotasi ke objek

  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di dalam daftar Bucket, pilih nama bucket yang berisi objek.

  3. Dalam daftar Objek, pilih nama objek yang ingin Anda anotasi.

  4. Pilih tab Properti.

  5. Gulir ke bagian Anotasi dan pilih Tambahkan anotasi.

  6. Untuk Nama, masukkan nama untuk anotasi (misalnya,ml.sentiment). Nama harus 1—512 byte dan dapat berisi huruf Unicode, digit, garis bawah, titik, dan tanda hubung. Nama tidak dapat dimulai dengan aws ataus3.

  7. Pilih Pilih file untuk mengunggah konten anotasi. File harus dapat UTF-8 dikodekan dan berukuran hingga 1 MB.

Untuk melengkapi anotasi

  1. (Opsional) Di bawah Checksum, pilih algoritma checksum.

  2. Pilih Tambahkan anotasi.

catatan

Untuk melihat konten anotasi setelah dibuat, Anda harus mengunduh anotasi. Konsol S3 tidak menampilkan konten anotasi sebaris.

Menggunakan AWS CLI

Untuk menambahkan atau memperbarui anotasi pada objek, gunakan put-object-annotation perintah. --annotation-payloadParameter menerima jalur file.

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

Untuk menulis anotasi hanya jika objek belum ditimpa sejak Anda terakhir membacanya, tentukan --object-if-match parameter dengan ETag objek saat ini.

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

Menggunakan AWS SDK

Contoh berikut menggunakan AWS SDK untuk Python (Boto3) untuk menambahkan anotasi ke objek.

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

Mengambil anotasi

Anda dapat mengambil anotasi tertentu atau mencantumkan semua anotasi pada suatu objek.

Menggunakan konsol S3

Untuk mengambil anotasi

  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di dalam daftar Bucket, pilih nama bucket yang berisi objek.

  3. Di daftar Objek, pilih nama objek.

  4. Pilih tab Properties dan gulir ke bagian Anotasi.

  5. Untuk melihat konten anotasi, pilih Unduh di sebelah nama anotasi.

Menggunakan AWS CLI

Untuk mengambil anotasi tertentu, gunakan perintah. get-object-annotation

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

Untuk membuat daftar semua anotasi pada objek, gunakan list-object-annotations perintah.

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

Menggunakan AWS SDK

Contoh berikut menggunakan AWS SDK for Python (Boto3) untuk mengambil dan mencantumkan anotasi.

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

Menghapus anotasi

Anda dapat menghapus anotasi tertentu dari objek. Penghapusan anotasi bersifat permanen dan tidak dapat dibatalkan.

Menggunakan konsol S3

Untuk menghapus anotasi

  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di dalam daftar Bucket, pilih nama bucket yang berisi objek.

  3. Di daftar Objek, pilih nama objek.

  4. Pilih tab Properties dan gulir ke bagian Anotasi.

  5. Pilih anotasi yang ingin Anda hapus.

  6. Pilih Hapus, lalu konfirmasikan penghapusan.

Menggunakan AWS CLI

Untuk menghapus anotasi tertentu, gunakan delete-object-annotation perintah.

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

Menggunakan AWS SDK

Contoh berikut menggunakan AWS SDK for Python (Boto3) untuk menghapus anotasi.

import boto3

s3 = boto3.client('s3')

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