Menerima peristiwa kegagalan replikasi dengan Notifikasi Peristiwa Amazon S3 - Amazon Simple Storage Service
Penyebab kegagalan replikasi Amazon S3

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 Wilayah AWS. Jika Anda telah mengaktifkan Kontrol Waktu Replikasi S3 (S3RTC) pada konfigurasi replikasi Anda, Anda juga dapat diberi tahu ketika objek tidak bereplikasi dalam ambang batas S3 15 menit untuk replikasi. RTC

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. Memantau replikasi dengan metrik, pemberitahuan acara, dan status

  • Jenis peristiwa s3:Replication:OperationFailedReplication memberi tahu Anda saat objek yang memenuhi syarat untuk replikasi gagal mereplikasi.

  • Jenis s3:Replication:OperationMissedThreshold peristiwa 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 saat objek yang memenuhi syarat untuk replikasi langsung (baik Replikasi Wilayah Tunggal [SRR] atau Replikasi Lintas Wilayah [CRR]) tidak lagi dilacak oleh metrik replikasi.

Untuk deskripsi lengkap dari semua jenis peristiwa replikasi yang didukung, lihat. Jenis acara yang didukung untukSQS,SNS, dan Lambda

Untuk daftar kode kegagalan yang ditangkap oleh Pemberitahuan Acara S3, lihatPenyebab kegagalan replikasi Amazon S3.

Anda dapat menerima Pemberitahuan Acara S3 melalui Amazon Simple Queue Service (AmazonSQS), Amazon Simple Notification Service SNS (Amazon), atau AWS Lambda Untuk informasi selengkapnya, lihat Notifikasi Peristiwa Amazon S3.

Untuk petunjuk tentang cara mengonfigurasi Notifikasi Peristiwa Amazon S3, lihat Mengaktifkan pemberitahuan peristiwa.

catatan

Selain mengaktifkan pemberitahuan acara, pastikan Anda juga mengaktifkan metrik Replikasi S3. Untuk informasi selengkapnya, lihat Mengaktifkan metrik Replikasi S3.

Berikut ini adalah contoh pesan yang dikirimkan Amazon S3 untuk menerbitkan peristiwa s3:Replication:OperationFailedReplication. Untuk informasi selengkapnya, lihat Struktur pesan peristiwa.

{
  "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.

Penyebab kegagalan replikasi Deskripsi
AssumeRoleNotPermitted Amazon S3 tidak dapat berasumsi AWS Identity and Access Management (IAM) peran yang ditentukan dalam konfigurasi replikasi atau dalam pekerjaan Operasi Batch.
DstBucketInvalidRegion Bucket tujuan tidak sama Wilayah AWS seperti 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.
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 Bagian AWS Key Management Service (AWS KMS) kunci untuk bucket tujuan tidak dalam status valid. Tinjau dan aktifkan yang diperlukan AWS KMS kunci. Untuk informasi lebih lanjut tentang mengelola AWS KMS kunci, lihat Status kunci AWS KMS kunci di AWS Key Management Service Panduan Pengembang.
DstKmsKeyNotFound Bagian 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 tidak ada untuk bucket tujuan.
DstMultipartInitNotPermitted Amazon S3 tidak dapat memulai unggahan objek multibagian ke bucket tujuan. Izin s3:ReplicateObject mungkin tidak ada untuk bucket tujuan.
DstMultipartPartUploadNotPermitted Amazon S3 tidak dapat mengunggah objek multibagian ke bucket tujuan. Izin s3:ReplicateObject mungkin tidak ada 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 tidak ada untuk bucket tujuan.
DstPutLegalHoldNotPermitted Amazon S3 tidak dapat menempatkan penahanan hukum Kunci Objek pada objek tujuan saat mereplikasi objek yang tidak dapat diubah. Izin s3:PutObjectLegalHold mungkin hilang untuk bucket tujuan. Untuk informasi selengkapnya, lihat Penahanan legal.
DstPutObjectNotPermitted Amazon S3 tidak dapat mereplikasi objek ke bucket tujuan. Izin s3:ReplicateObject atau s3:ObjectOwnerOverrideToBucketOwner 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 Ember sumber tidak sama Wilayah AWS seperti 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 Object Ownership disetel ke pilihan pemilik Bucket, maka objek bucket sumber harus memiliki pemilik bucket agar menjadi pemilik objek. bucket-owner-full-control ACL 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 tidak ada 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 Bagian AWS KMS kunci untuk ember sumber tidak dalam keadaan valid. Tinjau dan aktifkan yang diperlukan AWS KMS kunci. Untuk informasi lebih lanjut tentang mengelola AWS KMS kunci, lihat Status kunci AWS KMS kunci di AWS Key Management Service Panduan 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.

Menyiapkan izin untuk replikasi langsung

Memecahkan masalah replikasi