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 Konsol Manajemen AWS, AWS CLI, atau AWS SDK. 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 Konsol Manajemen AWS 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 A notasi dan pilih Tambahkan anotasi.

  6. Untuk Nama, masukkan nama untuk anotasi (misalnya,ml.sentiment). Nama harus berukuran 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 di UTF-8 kodekan 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 menambah 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 diganti sejak terakhir Anda 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 objek.

Menggunakan konsol S3

Untuk mengambil anotasi

  1. Masuk ke Konsol Manajemen AWS 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 A notasi.

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

Menggunakan AWS CLI

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

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

Untuk mencantumkan 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 untuk Python (Boto3) untuk mengambil dan membuat daftar 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 Konsol Manajemen AWS 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 A notasi.

  5. Pilih anotasi yang ingin Anda hapus.

  6. Pilih H apus, 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 untuk 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'
)