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 (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

  • 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 saat 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

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

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.

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 mengasumsikan peran AWS Identity and Access Management (IAM) yang ditentukan dalam konfigurasi replikasi atau dalam tugas Operasi Batch.

DstBucketInvalidRegion

Bucket tujuan tidak Wilayah AWS 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.

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 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 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 unggahan 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 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.

DstPutObjectNotPermitted

Amazon S3 tidak dapat mereplikasi objek ke bucket tujuan. Izin s3:ReplicateObject atau s3:ObjectOwnerOverrideToBucketOwner mungkin hilang untuk bucket tujuan.

DstPutRetentionNotPermitted

Amazon S3 tidak dapat menempatkan periode retensi pada objek tujuan saat mereplikasi objek yang tidak dapat diubah. Izin s3:PutObjectRetention mungkin tidak ada 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 Wilayah AWS 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 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

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

Menyiapkan izin untuk replikasi langsung

Memecahkan masalah replikasi