Mendapatkan informasi status replikasi - Amazon Simple Storage Service
Gambaran status replikasiStatus replikasi jika mereplikasi ke beberapa bucket tujuanStatus replikasi jika sinkronisasi modifikasi replika Amazon S3 diaktifkanMenggunakan informasi status replikasi dengan pekerjaan Batch ReplicationMenemukan status replikasi

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

Mendapatkan informasi status replikasi

Status replikasi dapat membantu Anda menentukan status saat ini dari objek yang sedang direplikasi. Status replikasi dari objek sumber akan kembali sebagai PENDING, COMPLETED, atau FAILED. Status replikasi dari replika akan mengembalikan REPLICA.

Anda juga dapat menggunakan nilai status replikasi saat membuat pekerjaan Replikasi Batch S3. Misalnya, Anda dapat menggunakan nilai status ini untuk mereplikasi objek yang belum pernah direplikasi atau replikasi gagal. Untuk informasi selengkapnya tentang penggunaan nilai-nilai ini dengan Replikasi Batch, lihatMenggunakan informasi status replikasi dengan pekerjaan Batch Replication.

Gambaran status replikasi

Dalam replikasi, Anda memiliki bucket sumber tempat Anda mengonfigurasi replikasi dan satu atau beberapa bucket tujuan tempat Amazon S3 mereplikasi objek. Saat Anda meminta objek (dengan menggunakanGetObject) atau metadata objek (dengan menggunakanHeadObject) dari bucket ini, Amazon S3 mengembalikan header dalam x-amz-replication-status respons:

  • Saat Anda meminta objek dari bucket sumber, Amazon S3 mengembalikan header x-amz-replication-status jika objek di permintaan Anda memenuhi syarat untuk replikasi.

    Misalnya, Anda menetapkan awalan objek TaxDocs dalam konfigurasi replikasi Anda untuk memberi tahu Amazon S3 agar hanya mereplikasi objek dengan awalan nama kunci TaxDocs. Objek apa pun yang Anda unggah yang memiliki awalan nama kunci ini—misalnya, TaxDocs/document1.pdf—akan direplikasi. Untuk permintaan objek dengan awalan nama kunci ini, Amazon S3 mengembalikan header x-amz-replication-status dengan salah satu nilai berikut untuk status replikasi objek: PENDING, COMPLETED, atau FAILED.

    catatan

    Jika replikasi objek gagal setelah Anda mengunggah sebuah objek, Anda tidak dapat mencoba ulang replikasi. Anda harus mengunggah objek lagi, atau Anda harus menggunakan Replikasi Batch S3 untuk mereplikasi objek yang gagal. Untuk informasi selengkapnya tentang menggunakan Replikasi Batch, lihatMereplikasi objek yang ada dengan Batch Replication.

    Objek bertransisi ke FAILED status untuk masalah seperti izin peran replikasi yang hilang, izin AWS Key Management Service (AWS KMS), atau izin bucket. Untuk kegagalan sementara, seperti jika bucket atau Region tidak tersedia, status replikasi tidak bertransisi keFAILED, tetapi tetap ada. PENDING Setelah sumber daya kembali online, Amazon S3 melanjutkan mereplikasi objek tersebut.

  • Saat Anda meminta objek dari bucket tujuan, jika objek dalam permintaan Anda adalah replika yang dibuat Amazon S3, Amazon S3 mengembalikan header x-amz-replication-status dengan nilai REPLICA.

catatan

Sebelum menghapus objek dari bucket sumber yang mengaktifkan replikasi, periksa status replikasi objek untuk memastikan bahwa objek telah direplikasi.

Jika konfigurasi Siklus Hidup S3 diaktifkan di bucket sumber, Amazon S3 menangguhkan tindakan siklus hidup hingga menandai status objek sebagai salah satu atau. COMPLETED FAILED

Status replikasi jika mereplikasi ke beberapa bucket tujuan

Saat Anda mereplikasi objek ke beberapa bucket tujuan, header x-amz-replication-status bertindak secara berbeda. Header objek sumber mengembalikan nilai COMPLETED hanya ketika replikasi berhasil ke semua tujuan. Header tetap pada nilai PENDING sampai replikasi telah selesai untuk semua tujuan. Jika satu atau beberapa tujuan gagal replikasi, header mengembalikan FAILED.

Status replikasi jika sinkronisasi modifikasi replika Amazon S3 diaktifkan

Saat aturan replikasi Anda mengaktifkan sinkronisasi modifikasi replika Amazon S3, replika dapat melaporkan status selain REPLICA. Jika perubahan metadata sedang dalam proses replikasi, header x-amz-replication-status mengembalikan PENDING. Jika sinkronisasi modifikasi replika gagal mereplikasi metadata, header akan mengembalikan FAILED. Jika metadata direplikasi dengan benar, replika mengembalikan header REPLICA.

Menggunakan informasi status replikasi dengan pekerjaan Batch Replication

Saat membuat pekerjaan Replikasi Batch, Anda dapat secara opsional menentukan filter tambahan, seperti tanggal pembuatan objek dan status replikasi, untuk mengurangi cakupan pekerjaan.

Anda dapat memfilter objek yang akan mereplikasi berdasarkan nilai ObjectReplicationStatuses, dengan memberikan satu atau beberapa nilai berikut:

  • "NONE"–Menunjukkan bahwa Amazon S3 belum pernah mencoba mereplikasi objek sebelumnya.

  • "FAILED"— Menunjukkan bahwa Amazon S3 telah mencoba, tetapi gagal, untuk mereplikasi objek sebelumnya.

  • "COMPLETED"–Menunjukkan bahwa Amazon S3 telah berhasil mereplikasi objek sebelumnya.

  • "REPLICA"— Menunjukkan bahwa ini adalah objek replika yang telah direplikasi Amazon S3 dari sumber lain.

Untuk informasi selengkapnya tentang penggunaan nilai status replikasi ini dengan Replikasi Batch, lihat. Filter untuk tugas Replikasi Batch

Menemukan status replikasi

Untuk mendapatkan status replikasi dari objek di dalam bucket, Anda dapat menggunakan alat Inventaris Amazon S3. Amazon S3 mengirimkan CSV file ke bucket tujuan yang Anda tentukan dalam konfigurasi inventaris. Anda juga dapat menggunakan Amazon Athena untuk memerika status replikasi dalam laporan persediaan. Untuk informasi selengkapnya tentang Inventaris Amazon S3, lihat Katalogisasi dan analisis data Anda dengan S3 Inventory.

Anda juga dapat menemukan status replikasi objek dengan menggunakan konsol Amazon S3, AWS Command Line Interface the AWS CLI(), atau. AWS SDK

Di konsol Amazon S3, Anda dapat melihat status replikasi objek di halaman detail objek.

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

  2. Di panel navigasi kiri, pilih Bucket.

  3. Dalam daftar Bucket tujuan umum, pilih nama bucket sumber replikasi.

  4. Di daftar Objek, pilih nama objek. Halaman detail objek akan muncul.

  5. Pada tab Properties, gulir ke bawah ke bagian Ikhtisar manajemen objek. Di bawah Konfigurasi manajemen, lihat nilai di bawah status Replikasi.

Gunakan head-object perintah AWS Command Line Interface (AWS CLI) untuk mengambil metadata objek, seperti yang ditunjukkan pada contoh berikut. Ganti amzn-s3-demo-source-bucket1 dengan nama bucket sumber replikasi Anda, dan ganti yang lain user input placeholders dengan informasi Anda sendiri.

aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-version-id

Perintah mengembalikan metadata objek, termasuk ReplicationStatus seperti yang ditunjukkan dalam contoh tanggapan berikut.

{
   "AcceptRanges":"bytes",
   "ContentType":"image/jpeg",
   "LastModified":"Mon, 23 Mar 2015 21:02:29 GMT",
   "ContentLength":3191,
   "ReplicationStatus":"COMPLETED",
   "VersionId":"jfnW.HIMOfYiD_9rGbSkmroXsFj3fqZ.",
   "ETag":"\"6805f2cfc46c0f04559748bb039d69ae\"",
   "Metadata":{

   }
}

Fragmen kode berikut mendapatkan status replikasi Anda dengan menggunakan AWS SDK for Java dan AWS SDK for .NET, masing-masing.

Java
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest(bucketName, key);
ObjectMetadata metadata = s3Client.getObjectMetadata(metadataRequest);

System.out.println("Replication Status : " + metadata.getRawMetadataValue(Headers.OBJECT_REPLICATION_STATUS));
.NET
GetObjectMetadataRequest getmetadataRequest = new GetObjectMetadataRequest
    {
         BucketName = sourceBucket,
         Key        = objectKey
    };

GetObjectMetadataResponse getmetadataResponse = client.GetObjectMetadata(getmetadataRequest);
Console.WriteLine("Object replication status: {0}", getmetadataResponse.ReplicationStatus);