Amazon S3 이벤트 알림을 사용하여 복제 실패 이벤트 수신

복제 구성에서 S3 복제 지표를 활성화한 경우 객체가 대상 AWS 리전으로 복제되지 않을 때 알리도록 Amazon S3 이벤트 알림을 설정할 수 있습니다. 복제 구성에서 S3 Replication Time Control(S3 RTC)을 활성화한 경우, 복제에 대한 15분 S3 RTC 임계값 내에 객체가 복제되지 않을 때도 알림을 받을 수 있습니다.

다음 Replication 이벤트 유형을 사용하여 보류 중인 바이트, 보류 중인 작업, 복제 지연 시간을 추적하면서 복제 이벤트의 진행 상황을 분 단위로 모니터링할 수 있습니다. S3 복제 지표에 대한 자세한 내용은 지표, 이벤트 알림 및 상태를 통한 복제 모니터링 섹션을 참조하세요.

지원되는 모든 복제 이벤트 유형에 대한 자세한 설명은 SQS, SNS 및 Lambda에 지원되는 이벤트 유형 섹션을 참조하세요.

S3 이벤트 알림에서 캡처한 실패 코드 목록은 Amazon S3 복제 실패 이유 섹션을 참조하세요.

Amazon Simple Queue Service(Amazon SQS), Amazon Simple Notification Service(Amazon SNS) 또는 AWS Lambda를 통해 S3 이벤트 알림을 받을 수 있습니다. 자세한 내용은 Amazon S3 이벤트 알림 단원을 참조하십시오.

Amazon S3 이벤트 알림을 구성하는 방법에 대한 지침은 이벤트 알림 사용 설정를 참조하세요.

다음은 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 복제 실패 이유가 나열되어 있습니다. Amazon S3 이벤트 알림이 포함된 s3:Replication:OperationFailedReplication 이벤트를 수신한 후 failureReason 값을 보면 그 이유를 알 수 있습니다.

S3 배치 복제 완료 보고서에서도 이러한 실패 이유를 확인할 수 있습니다. 자세한 내용은 배치 복제 완료 보고서 단원을 참조하십시오.

관련 주제

라이브 복제에 대한 권한 설정

복제 문제 해결