Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menerima peristiwa kegagalan replikasi dengan Notifikasi Peristiwa Amazon S3
Jika Anda telah mengaktifkan metrik Replikasi S3 pada konfigurasi replikasi, Anda dapat mengatur Pemberitahuan Acara Amazon S3 untuk memberi tahu Anda saat objek tidak mereplikasi ke tujuannya. AWS Region Jika Anda telah mengaktifkan Kontrol Waktu Replikasi S3 (S3 RTC) pada konfigurasi replikasi Anda, Anda juga dapat diberi tahu ketika objek tidak bereplikasi dalam ambang batas S3 RTC 15 menit untuk replikasi.
Dengan menggunakan jenis `Replication` peristiwa berikut, Anda dapat memantau minute-by-minute kemajuan peristiwa replikasi dengan melacak byte yang tertunda, operasi tertunda, dan latensi replikasi. Untuk informasi selengkapnya tentang metrik Replikasi S3, lihat. [Menggunakan metrik Replikasi S3](repl-metrics.md)
+ Jenis peristiwa `s3:Replication:OperationFailedReplication` memberi tahu Anda saat objek yang memenuhi syarat untuk replikasi gagal mereplikasi.
+ Jenis `s3:Replication:OperationMissedThreshold` acara memberi tahu Anda ketika objek yang memenuhi syarat untuk replikasi yang menggunakan S3 RTC melebihi ambang batas 15 menit untuk replikasi.
+ Jenis `s3:Replication:OperationReplicatedAfterThreshold` acara memberi tahu Anda saat objek yang memenuhi syarat untuk replikasi yang menggunakan S3 RTC bereplikasi setelah ambang batas 15 menit.
+ Jenis `s3:Replication:OperationNotTracked` acara memberi tahu Anda ketika objek yang memenuhi syarat untuk replikasi langsung (baik Same-Region Replication [SRR] atau Cross-Region Replication [CRR]) tidak lagi dilacak oleh metrik replikasi.
Untuk deskripsi lengkap dari semua jenis peristiwa replikasi yang didukung, lihat. [Jenis event yang didukung untuk SQS, SNS, dan Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types)
Untuk daftar kode kegagalan yang ditangkap oleh Pemberitahuan Acara S3, lihat[Penyebab kegagalan replikasi Amazon S3](#replication-failure-codes).
Anda dapat menerima Notifikasi Peristiwa S3 melalui Amazon Simple Queue Service (Amazon SQS), Amazon Simple Notiļ¬cation Service (Amazon SNS), atau AWS Lambda. Untuk informasi selengkapnya, lihat [Notifikasi Peristiwa Amazon S3](EventNotifications.md).
Untuk petunjuk tentang cara mengonfigurasi Notifikasi Peristiwa Amazon S3, lihat [ Mengaktifkan pemberitahuan peristiwa](how-to-enable-disable-notification-intro.md).
**catatan**
Selain mengaktifkan pemberitahuan acara, pastikan Anda juga mengaktifkan metrik Replikasi S3. Untuk informasi selengkapnya, lihat [Mengaktifkan metrik Replikasi S3](repl-metrics.md#enabling-replication-metrics).
Berikut ini adalah contoh pesan yang dikirimkan Amazon S3 untuk menerbitkan peristiwa `s3:Replication:OperationFailedReplication`. Untuk informasi selengkapnya, lihat [Struktur pesan peristiwa](notification-content-structure.md).
```
{
"Records": [
{
"eventVersion": "2.2",
"eventSource": "aws:s3",
"awsRegion": "us-east-1",
"eventTime": "2024-09-05T21:04:32.527Z",
"eventName": "Replication:OperationFailedReplication",
"userIdentity": {
"principalId": "s3.amazonaws.com"
},
"requestParameters": {
"sourceIPAddress": "s3.amazonaws.com"
},
"responseElements": {
"x-amz-request-id": "123bf045-2b4b-4ca8-a211-c34a63c59426",
"x-amz-id-2": "12VAWNDIHnwJsRhTccqQTeAPoXQmRt22KkewMV8G3XZihAuf9CLDdmkApgZzudaIe2KlLfDqGS0="
},
"s3": {
"s3SchemaVersion": "1.0",
"configurationId": "ReplicationEventName",
"bucket": {
"name": "amzn-s3-demo-bucket1",
"ownerIdentity": {
"principalId": "111122223333"
},
"arn": "arn:aws:s3:::amzn-s3-demo-bucket1"
},
"object": {
"key": "replication-object-put-test.png",
"size": 520080,
"eTag": "e12345ca7e88a38428305d3ff7fcb99f",
"versionId": "abcdeH0Xp66ep__QDjR76LK7Gc9X4wKO",
"sequencer": "0066DA1CBF104C0D51"
}
},
"replicationEventData": {
"replicationRuleId": "notification-test-replication-rule",
"destinationBucket": "arn:aws:s3:::amzn-s3-demo-bucket2",
"s3Operation": "OBJECT_PUT",
"requestTime": "2024-09-05T21:03:59.168Z",
"failureReason": "AssumeRoleNotPermitted"
}
}
]
}
```
## Penyebab kegagalan replikasi Amazon S3
Tabel berikut mencantumkan alasan kegagalan replikasi Amazon S3. Anda dapat melihat alasan ini dengan menerima `s3:Replication:OperationFailedReplication` acara dengan Pemberitahuan Acara Amazon S3 dan kemudian melihat nilainya. `failureReason`
Anda juga dapat melihat alasan kegagalan ini dalam laporan penyelesaian Replikasi Batch S3. Untuk informasi selengkapnya, lihat [Laporan penyelesaian Replikasi Batch](s3-batch-replication-batch.md#batch-replication-completion-report).
| Penyebab kegagalan replikasi | Deskripsi |
| --- | --- |
| `AssumeRoleNotPermitted` | Amazon S3 tidak dapat mengasumsikan peran AWS Identity and Access Management (IAM) yang ditentukan dalam konfigurasi replikasi atau dalam tugas Operasi Batch. |
| `DstBucketInvalidRegion` | Bucket tujuan tidak AWS Region sama dengan yang ditentukan oleh pekerjaan Operasi Batch. Kesalahan ini khusus untuk Replikasi Batch. |
| `DstBucketNotFound` | Amazon S3 tidak dapat menemukan bucket tujuan yang ditentukan dalam konfigurasi replikasi. |
| `DstBucketObjectLockConfigMissing` | Untuk mereplikasi objek dari bucket sumber dengan dukungan Kunci Objek, bucket tujuan juga harus memiliki Kunci Objek yang diaktifkan. Kesalahan ini menunjukkan bahwa Kunci Objek mungkin tidak diaktifkan di bucket tujuan. Untuk informasi selengkapnya, lihat [Pertimbangan Kunci Objek](object-lock-managing.md). |
| `DstBucketUnversioned` | Penentuan Versi tidak diaktifkan untuk bucket tujuan S3. Untuk mereplikasi objek dengan Replikasi S3, aktifkan Penentuan Versi untuk bucket tujuan. |
| `DstDelObjNotPermitted` | Amazon S3 tidak dapat mereplikasi penanda hapus ke bucket tujuan. Izin `s3:ReplicateDelete` mungkin hilang untuk bucket tujuan. |
| `DstKmsKeyInvalidState` | Kunci AWS Key Management Service (AWS KMS) untuk bucket tujuan tidak dalam status valid. Tinjau dan aktifkan AWS KMS kunci yang diperlukan. Untuk informasi selengkapnya tentang mengelola AWS KMS [kunci, lihat Status AWS KMS kunci kunci](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) di *Panduan AWS Key Management Service Pengembang*. |
| `DstKmsKeyNotFound` | AWS KMS Kunci yang dikonfigurasi untuk bucket tujuan dalam konfigurasi replikasi tidak ada. |
| `DstMultipartCompleteNotPermitted` | Amazon S3 tidak dapat menyelesaikan unggahan objek multibagian di bucket tujuan. Izin `s3:ReplicateObject` mungkin hilang untuk bucket tujuan. |
| `DstMultipartInitNotPermitted` | Amazon S3 tidak dapat memulai unggahan objek multibagian ke bucket tujuan. Izin `s3:ReplicateObject` mungkin hilang untuk bucket tujuan. |
| `DstMultipartUploadNotPermitted` | Amazon S3 tidak dapat mengunggah objek unggahan multibagian ke bucket tujuan. Izin `s3:ReplicateObject` mungkin hilang untuk bucket tujuan. |
| `DstObjectHardDeleted` | Replikasi Batch S3 tidak mendukung replikasi ulang objek yang dihapus dengan ID versi objek dari bucket tujuan. Kesalahan ini khusus untuk Replikasi Batch. |
| `DstPutAclNotPermitted` | Amazon S3 tidak dapat mereplikasi daftar kontrol akses objek (ACLs) ke bucket tujuan. Izin `s3:ReplicateObject` mungkin hilang untuk bucket tujuan. |
| `DstPutLegalHoldNotPermitted` | Amazon S3 tidak dapat menempatkan penahanan hukum Object Lock pada objek tujuan saat mereplikasi objek yang tidak dapat diubah. Izin `s3:PutObjectLegalHold` mungkin hilang untuk bucket tujuan. Untuk informasi selengkapnya, lihat [Penahanan legal](object-lock.md#object-lock-legal-holds). |
| `DstPutObjectNotPermitted` | Amazon S3 tidak dapat mereplikasi objek ke bucket tujuan. Hal ini dapat terjadi ketika izin (`s3:ReplicateObject`atau `s3:ObjectOwnerOverrideToBucketOwner` izin) yang diperlukan hilang untuk bucket tujuan atau ketika kebijakan AWS KMS kunci tidak mengizinkan peran replikasi bucket sumber untuk menggunakan AWS KMS kunci (`kms:Decrypt`dan `kms:GenerateDataKey*` tindakan) di bucket tujuan. |
| `DstPutRetentionNotPermitted` | Amazon S3 tidak dapat menempatkan periode retensi pada objek tujuan saat mereplikasi objek yang tidak dapat diubah. Izin `s3:PutObjectRetention` mungkin hilang untuk bucket tujuan. |
| `DstPutTaggingNotPermitted` | Amazon S3 tidak dapat mereplikasi tag objek ke bucket tujuan. Izin `s3:ReplicateObject` mungkin hilang untuk bucket tujuan. |
| `DstVersionNotFound ` | Amazon S3 tidak dapat menemukan versi objek yang diperlukan di bucket tujuan yang metadatanya perlu direplikasi. |
| `InitiateReplicationNotPermitted` | Amazon S3 tidak dapat memulai replikasi pada objek. Izin `s3:InitiateReplication` mungkin hilang untuk tugas Operasi Batch. Kesalahan ini khusus untuk Replikasi Batch. |
| `SrcBucketInvalidRegion` | Bucket sumber tidak AWS Region sama dengan yang ditentukan oleh pekerjaan Operasi Batch. Kesalahan ini khusus untuk Replikasi Batch. |
| `SrcBucketNotFound` | Amazon S3 tidak dapat menemukan bucket sumber. |
| `SrcBucketReplicationConfigMissing` | Amazon S3 tidak dapat menemukan konfigurasi replikasi untuk bucket sumber. |
| `SrcGetAclNotPermitted` | Amazon S3 tidak dapat mengakses objek di bucket sumber untuk replikasi. Izin `s3:GetObjectVersionAcl` mungkin hilang untuk objek bucket sumber.
Objek di bucket sumber harus dimiliki oleh pemilik bucket. Jika ACLs diaktifkan, verifikasi apakah Kepemilikan Objek disetel ke pilihan pemilik Bucket atau penulis Object. Jika Kepemilikan Objek ditetapkan ke Pemilik bucket pilihan, objek bucket sumber harus memiliki ACL `bucket-owner-full-control` agar pemilik bucket menjadi pemilik objek. Akun sumber dapat mengambil kepemilikan semua objek di bucket mereka dengan menyetel Kepemilikan Objek ke pemilik Bucket yang diberlakukan dan ACLs dinonaktifkan. |
| `SrcGetLegalHoldNotPermitted` | Amazon S3 tidak dapat mengakses informasi penahanan hukum Kunci Objek S3. |
| `SrcGetObjectNotPermitted` | Amazon S3 tidak dapat mengakses objek di bucket sumber untuk replikasi. Izin `s3:GetObjectVersionForReplication` mungkin hilang untuk bucket sumber. |
| `SrcGetRetentionNotPermitted` | Amazon S3 tidak dapat mengakses informasi periode retensi Kunci Objek S3. |
| `SrcGetTaggingNotPermitted` | Amazon S3 tidak dapat mengakses informasi tag objek dari bucket sumber. Izin `s3:GetObjectVersionTagging` mungkin hilang untuk bucket sumber. |
| `SrcHeadObjectNotPermitted` | Amazon S3 tidak dapat mengambil metadata objek dari bucket sumber. Izin `s3:GetObjectVersionForReplication` mungkin hilang untuk bucket sumber. |
| `SrcKeyNotFound` | Amazon S3 tidak dapat menemukan kunci objek sumber yang akan direplikasi. Objek sumber mungkin telah dihapus sebelum replikasi selesai. |
| `SrcKmsKeyInvalidState` | AWS KMS Kunci untuk bucket sumber tidak dalam status valid. Tinjau dan aktifkan AWS KMS kunci yang diperlukan. Untuk informasi selengkapnya tentang mengelola AWS KMS [kunci, lihat Status AWS KMS kunci kunci](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) di *Panduan AWS Key Management Service Pengembang*. |
| `SrcObjectNotEligible` | Beberapa objek tidak memenuhi syarat untuk replikasi. Ini mungkin karena kelas penyimpanan objek atau tag objek tidak cocok dengan konfigurasi replikasi. |
| `SrcObjectNotFound` | Objek sumber tidak ada. |
| `SrcReplicationNotPending` | Amazon S3 telah mereplikasi objek ini. Objek ini tidak lagi menunggu replikasi. |
| `SrcVersionNotFound` | Amazon S3 tidak dapat menemukan versi objek sumber yang akan direplikasi. Versi objek sumber mungkin telah dihapus sebelum replikasi selesai. |
### Topik terkait
[Menyiapkan izin untuk replikasi langsung](setting-repl-config-perm-overview.md)
[Memecahkan masalah replikasi](replication-troubleshoot.md)