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, lihat[Menggunakan informasi status replikasi dengan pekerjaan Batch Replication](#replication-status-batch-replication).
**Topics**
+ [Gambaran status replikasi](#replication-status-overview)
+ [Status replikasi jika mereplikasi ke beberapa bucket tujuan](#replication-status-multiple-destinations)
+ [Status replikasi jika sinkronisasi modifikasi replika Amazon S3 diaktifkan](#replication-status-replica-mod-syn)
+ [Menggunakan informasi status replikasi dengan pekerjaan Batch Replication](#replication-status-batch-replication)
+ [Menemukan status replikasi](#replication-status-usage)
## 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 menggunakan`GetObject`) atau metadata objek (dengan menggunakan`HeadObject`) 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. Siklus Hidup S3 memblokir tindakan kedaluwarsa dan transisi pada objek dengan atau status replikasi. `PENDING` `FAILED` Untuk informasi selengkapnya tentang menggunakan Replikasi Batch, lihat[Mereplikasi objek yang ada dengan Batch Replication](s3-batch-replication-batch.md).
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 ke`FAILED`, 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 replikasi objek sebagai. `COMPLETED` Jika status replikasi`FAILED`, Siklus Hidup S3 terus memblokir tindakan kedaluwarsa dan transisi pada objek hingga Anda menyelesaikan masalah replikasi yang mendasarinya. Untuk informasi selengkapnya, lihat [Siklus Hidup S3 dan](lifecycle-and-other-bucket-config.md#lifecycle-and-replication).
## 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](s3-batch-replication-batch.md#batch-replication-filters)
## Menemukan status replikasi
Untuk mendapatkan status replikasi dari objek di dalam bucket, Anda dapat menggunakan alat Inventaris Amazon S3. Amazon S3 mengirim file CSV ke bucket tujuan yang Anda tentukan dalam konfigurasi persediaan. Anda juga dapat menggunakan Amazon Athena untuk memerika status replikasi dalam laporan persediaan. Untuk informasi selengkapnya tentang Inventaris Amazon S3, lihat [Membuat katalog dan menganalisis data Anda dengan S3 Inventory](storage-inventory.md).
Anda juga dapat menemukan status replikasi objek dengan menggunakan konsol Amazon S3, AWS Command Line Interface the AWS CLI(), atau AWS SDK.
### Menggunakan konsol S3
Di konsol Amazon S3, Anda dapat melihat status replikasi untuk objek di halaman detail objek.
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket**.
1. Dalam daftar **Bucket tujuan umum**, pilih nama bucket sumber replikasi.
1. Di daftar **Objek**, pilih nama objek. Halaman detail objek akan muncul.
1. Pada tab **Properties**, gulir ke bawah ke bagian **Ikhtisar manajemen objek**. Di bawah **Konfigurasi manajemen**, lihat nilai di bawah Status **replikasi.**
### Menggunakan AWS CLI
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":{
}
}
```
### Menggunakan AWS SDKs
Fragmen kode berikut mendapatkan status replikasi Anda dengan menggunakan AWS SDK untuk Java dan AWS SDK untuk .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);
```
------