View a markdown version of this page

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 Peristiwa Amazon S3 untuk memberi tahu Anda saat objek tidak mereplikasi ke tujuannya Wilayah AWS. Jika Anda telah mengaktifkan S3 Replication Time Control (S3 RTC) pada konfigurasi replikasi, Anda juga dapat diberi tahu saat objek tidak mereplikasi dalam ambang batas S3 RTC 15 menit untuk replikasi.

penting

Untuk menerima notifikasi peristiwa kegagalan replikasi (s3:Replication:OperationFailedReplication), Anda harus mengaktifkan metrik Replikasi S3 pada aturan replikasi Anda. Anda tidak perlu mengaktifkan S3 Replication Time Control (S3 RTC) untuk menerima pemberitahuan kegagalan. S3 RTC hanya diperlukan untuk notifikasi berbasis ambang batas (dan). s3:Replication:OperationMissedThreshold s3:Replication:OperationReplicatedAfterThreshold Anda dapat mengaktifkan metrik Replikasi S3 secara independen dari S3 RTC. Untuk informasi selengkapnya, lihat Mengaktifkan metrik Replikasi S3.

Dengan menggunakan jenis Replication peristiwa berikut, Anda dapat memantau kemajuan peristiwa replikasi menit demi menit dengan melacak byte yang tertunda, operasi tertunda, dan latensi replikasi. Untuk informasi selengkapnya tentang metrik Replikasi S3, lihatMenggunakan metrik Replikasi S3.

  • 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 peristiwa memberi tahu Anda ketika objek yang memenuhi syarat untuk replikasi yang menggunakan S3 RTC bereplikasi setelah ambang batas 15 menit.

  • Jenis s3:Replication:OperationNotTracked peristiwa memberi tahu Anda ketika objek yang memenuhi syarat untuk replikasi langsung (baik Replikasi [SRR] atau Same-Region Rep Cross-Region likasi [CRR]) tidak lagi dilacak oleh metrik replikasi.

Untuk deskripsi lengkap dari semua jenis peristiwa replikasi yang didukung, lihatJenis event yang didukung untuk SQS, SNS, dan Lambda.

Untuk daftar kode kegagalan yang ditangkap oleh Pemberitahuan Peristiwa 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.

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 Peristiwa Amazon S3 dan kemudian melihat nil failureReason ainya.

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 mengambil peran AWS Identity and Access Management (IAM) 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

K AWS Key Management Service unci (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 Peng AWS Key Management Service embang.

DstKmsKeyNotFound

K AWS KMS unci 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 multipart 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 (ACL) objek ke bucket tujuan. Izin s3:ReplicateObject mungkin hilang untuk bucket tujuan.

DstPutLegalHoldNotPermitted

Amazon S3 tidak dapat menahan Object Lock secara legal 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. Hal ini dapat terjadi ketika izin (s3:ReplicateObjectatau 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:Decryptdan 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 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 ACL diaktifkan, pastikan apakah Kepemilikan Objek ditetapkan ke Pemilik bucket pilihan atau Penulis objek. 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 menetapkan Kepemilikan Objek ke Pemilik bucket yang diberlakukan dan menonaktifkan ACL.

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

K AWS KMS unci 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 Peng AWS Key Management Service embang.

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.

SrcAnnotationNotFound

Anotasi sumber tidak ditemukan. Anotasi telah dihapus sebelum replikasi selesai.

SrcGetObjectAnnotationNotPermitted

Akses ditolak saat mengambil anotasi sumber untuk replikasi. Peran IAM hilangs3:GetObjectVersionAnnotationForReplication.

DstPutObjectAnnotationNotPermitted

Akses ditolak saat mereplikasi anotasi ke bucket tujuan. Peran IAM hilang s3:ReplicateObject atau tidak memiliki akses ke AWS KMS kunci yang diperlukan.

SrcAnnotationEncryptionUnsupported

Jenis enkripsi anotasi objek tidak didukung.

AnnotationLimitExceeded

Jumlah anotasi objek melebihi batas (1000). Replikasi akan melebihi batas anotasi pada tujuan.

Menyiapkan izin untuk replikasi langsung

Memecahkan masalah replikasi