Amazon S3 Event Notifications로 복제 실패 이벤트 받기

Amazon S3 Event Notifications로 복제 실패 이벤트 받기

복제 구성에서 S3 복제 지표를 활성화했다면, 객체가 대상 AWS 리전으로 복제되지 않을 때 알림을 받도록 Amazon S3 Event Notifications를 설정할 수 있어요. 복제 구성에서 S3 Replication Time Control(S3 RTC)을 활성화했다면 객체가 복제의 15분 S3 RTC 임계값 안에 복제되지 않을 때도 알림을 받을 수 있어요.

중요: 복제 실패 이벤트 알림(s3:Replication:OperationFailedReplication)을 받으려면 복제 규칙에서 S3 복제 지표를 활성화해야 해요. 실패 알림을 받기 위해 S3 Replication Time Control(S3 RTC)을 활성화할 필요는 없어요. S3 RTC는 임계값 기반 알림(s3:Replication:OperationMissedThreshold와 s3:Replication:OperationReplicatedAfterThreshold)에만 필요합니다. S3 복제 지표는 S3 RTC와 별개로 활성화할 수 있어요. 자세한 내용은 S3 복제 지표 활성화 문서를 참고하세요.

다음 Replication 이벤트 유형을 사용하면 보류 중인 바이트, 보류 중인 작업, 복제 지연 시간을 추적해 복제 이벤트의 분 단위 진행 상황을 모니터링할 수 있어요. S3 복제 지표에 대한 자세한 내용은 S3 복제 지표 사용 문서를 참고하세요.

• s3:Replication:OperationFailedReplication 이벤트 유형은 복제 자격이 있는 객체가 복제에 실패했을 때 알려줘요.
• s3:Replication:OperationMissedThreshold 이벤트 유형은 S3 RTC를 사용하는 복제 자격이 있는 객체가 15분 복제 임계값을 초과했을 때 알려줘요.
• s3:Replication:OperationReplicatedAfterThreshold 이벤트 유형은 S3 RTC를 사용하는 복제 자격이 있는 객체가 15분 임계값 이후에 복제됐을 때 알려줘요.
• s3:Replication:OperationNotTracked 이벤트 유형은 라이브 복제(Same-Region Replication[SRR] 또는 Cross-Region Replication[CRR]) 자격이 있는 객체가 복제 지표로 더 이상 추적되지 않을 때 알려줘요.

지원되는 모든 복제 이벤트 유형에 대한 전체 설명은 SQS, SNS, Lambda에 대한 지원 이벤트 유형 문서를 참고하세요. S3 Event Notifications가 포착하는 실패 코드 목록은 Amazon S3 복제 실패 이유 문서를 참고하세요.

S3 Event Notifications는 Amazon Simple Queue Service(Amazon SQS), Amazon Simple Notification Service(Amazon SNS), AWS Lambda를 통해 받을 수 있어요. 자세한 내용은 Amazon S3 Event Notifications 문서를 참고하세요. Amazon S3 Event Notifications를 구성하는 방법은 이벤트 알림 활성화 문서를 참고하세요.

다음은 Amazon S3가 s3:Replication:OperationFailedReplication 이벤트를 게시하기 위해 보내는 메시지의 예시예요. 자세한 내용은 이벤트 메시지 구조 문서를 참고하세요.

{
   "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"
         }
      }
   ]
}

출처: 문서

Amazon S3 복제 실패 이유

다음 표에는 Amazon S3 Replication 실패 이유가 나와 있어요. Amazon S3 Event Notifications로 s3:Replication:OperationFailedReplication 이벤트를 받은 뒤 failureReason 값을 보면 이 이유를 확인할 수 있어요.

이 실패 이유는 S3 Batch Replication 완료 보고서에서도 볼 수 있어요. 자세한 내용은 Batch Replication 완료 보고서 문서를 참고하세요.

관련 주제

• 라이브 복제 권한 설정
• 복제 문제 해결
• S3 Storage Lens 대시보드에서 복제 지표 보기
• 복제 상태 정보 가져오기