Amazon S3 이벤트 알림을 사용하여 복제 실패 이벤트 수신
복제 구성에서 S3 복제 지표를 활성화한 경우 객체가 대상 AWS 리전으로 복제되지 않을 때 알리도록 Amazon S3 이벤트 알림을 설정할 수 있습니다. 복제 구성에서 S3 Replication Time Control(S3 RTC)을 활성화한 경우, 복제에 대한 15분 S3 RTC 임계값 내에 객체가 복제되지 않을 때도 알림을 받을 수 있습니다.
다음 Replication
이벤트 유형을 사용하여 보류 중인 바이트, 보류 중인 작업, 복제 지연 시간을 추적하면서 복제 이벤트의 진행 상황을 분 단위로 모니터링할 수 있습니다. S3 복제 지표에 대한 자세한 내용은 S3 복제 지표 사용 섹션을 참조하세요.
-
s3:Replication:OperationFailedReplication
이벤트 유형은 복제에 적합한 객체가 복제에 실패할 때 알려줍니다. -
s3:Replication:OperationMissedThreshold
이벤트 유형은 S3 RTC를 사용하는 복제 대상 객체가 복제 임계값인 15분을 초과하면 알려줍니다. -
s3:Replication:OperationReplicatedAfterThreshold
이벤트 유형은 S3 RTC를 사용하는 복제 대상 객체가 15분 임계값 이후에 복제되면 알려줍니다. -
s3:Replication:OperationNotTracked
이벤트 유형은 라이브 복제 대상 객체(동일 리전 복제[SRR] 또는 교차 리전 복제[CRR])가 더 이상 복제 지표로 추적되지 않으면 알려줍니다.
지원되는 모든 복제 이벤트 유형에 대한 자세한 설명은 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 이벤트 알림을 구성하는 방법에 대한 지침은 이벤트 알림 사용 설정를 참조하세요.
참고
이벤트 알림뿐만 아니라 S3 복제 지표도 활성화해야 합니다. 자세한 내용은 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 배치 복제 완료 보고서에서도 이러한 실패 이유를 확인할 수 있습니다. 자세한 내용은 배치 복제 완료 보고서 단원을 참조하십시오.
복제 실패 이유 | 설명 |
---|---|
AssumeRoleNotPermitted |
Amazon S3가 복제 구성 또는 배치 작업에 지정된 AWS Identity and Access Management(IAM) 역할을 맡을 수 없습니다. |
DstBucketInvalidRegion |
대상 버킷의 위치가 배치 작업에 지정된 AWS 리전과 동일하지 않습니다. 이 오류는 배치 복제에만 해당합니다. |
DstBucketNotFound |
Amazon S3가 복제 구성에 지정된 대상 버킷을 찾을 수 없습니다. |
DstBucketObjectLockConfigMissing |
객체 잠금이 활성화된 소스 버킷에서 객체를 복제하려면 대상 버킷에도 객체 잠금이 활성화되어 있어야 합니다. 이 오류는 대상 버킷에서 객체 잠금이 활성화되지 않았을 수 있다는 것을 나타냅니다. 자세한 내용은 객체 잠금 고려 사항 단원을 참조하십시오. |
DstBucketUnversioned |
S3 대상 버킷에서 버전 관리가 활성화되지 않았습니다. S3 복제로 객체를 복제하려면 대상 버킷에서 버전 관리를 활성화합니다. |
DstDelObjNotPermitted |
Amazon S3가 대상 버킷으로 삭제 마커를 복제할 수 없습니다. 대상 버킷에 대한 s3:ReplicateDelete 권한이 누락되었을 수 있습니다. |
DstKmsKeyInvalidState |
대상 버킷의 AWS Key Management Service(AWS KMS) 키가 유효하지 않은 상태입니다. 필요한 AWS KMS 키를 검토하고 활성화합니다. AWS KMS 키 관리에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 AWS KMS 키의 키 상태를 참조하세요. |
DstKmsKeyNotFound |
복제 구성에서 대상 버킷에 대해 구성된 AWS KMS 키가 존재하지 않습니다. |
DstMultipartCompleteNotPermitted |
Amazon S3가 대상 버킷에 있는 객체의 멀티파트 업로드를 완료할 수 없습니다. 대상 버킷에 대한 s3:ReplicateObject 권한이 누락되었을 수 있습니다. |
DstMultipartInitNotPermitted |
Amazon S3가 대상 버킷으로 객체의 멀티파트 업로드를 시작할 수 없습니다. 대상 버킷에 대한 s3:ReplicateObject 권한이 누락되었을 수 있습니다. |
DstMultipartPartUploadNotPermitted |
Amazon S3가 대상 버킷으로 멀티파트 업로드 객체를 업로드할 수 없습니다. 대상 버킷에 대한 s3:ReplicateObject 권한이 누락되었을 수 있습니다. |
DstObjectHardDeleted |
S3 배치 복제가 대상 버킷에서 객체의 버전 ID로 삭제된 객체를 다시 복제하는 것을 지원하지 않습니다. 이 오류는 배치 복제에만 해당합니다. |
DstPutAclNotPermitted |
Amazon S3가 대상 버킷으로 객체 액세스 제어 목록(ACL)을 복제할 수 없습니다. 대상 버킷에 대한 s3:ReplicateObject 권한이 누락되었을 수 있습니다. |
DstPutLegalHoldNotPermitted |
Amazon S3가 변경 불가능한 객체를 복제하는 동안 대상 객체에 객체 잠금 법적 보류를 적용할 수 없습니다. 대상 버킷에 대한 s3:PutObjectLegalHold 권한이 누락되었을 수 있습니다. 자세한 내용은 법적 보존 단원을 참조하십시오. |
DstPutObjectNotPermitted |
Amazon S3가 대상 버킷으로 객체를 복제할 수 없습니다. 대상 버킷에 대한 s3:ReplicateObject 또는 s3:ObjectOwnerOverrideToBucketOwner 권한이 누락되었을 수 있습니다. |
DstPutTaggingNotPermitted |
Amazon S3가 대상 버킷으로 객체 태그를 복제할 수 없습니다. 대상 버킷에 대한 s3:ReplicateObject 권한이 누락되었을 수 있습니다. |
DstVersionNotFound |
Amazon S3가 대상 버킷에서 메타데이터를 복제해야 하는 필요한 객체 버전을 찾을 수 없습니다. |
InitiateReplicationNotPermitted |
Amazon S3가 객체에 복제를 시작할 수 없습니다. 배치 작업에 대한 s3:InitiateReplication 권한이 누락되었을 수 있습니다. 이 오류는 배치 복제에만 해당합니다. |
SrcBucketInvalidRegion |
소스 버킷의 위치가 배치 작업에 지정된 AWS 리전과 동일하지 않습니다. 이 오류는 배치 복제에만 해당합니다. |
SrcBucketNotFound |
Amazon S3가 소스 버킷을 찾을 수 없습니다. |
SrcBucketReplicationConfigMissing |
Amazon S3가 소스 버킷의 복제 구성을 찾을 수 없습니다. |
SrcGetAclNotPermitted |
Amazon S3가 복제를 위해 소스 버킷의 객체에 액세스할 수 없습니다. 소스 버킷 객체에 대한 소스 버킷의 객체는 버킷 소유자가 소유하고 있어야 합니다. ACL이 사용 설정되어 있는 경우, 객체 소유권이 버킷 소유자 기본 설정 또는 객체 작성자로 설정되어 있는지 확인합니다. 객체 소유권이 버킷 소유자 선호로 설정된 경우, 버킷 소유자가 객체 소유자가 되려면 소스 버킷 객체에 |
SrcGetLegalHoldNotPermitted |
Amazon S3가 S3 객체 잠금 법적 보존 정보에 액세스할 수 없습니다. |
SrcGetObjectNotPermitted |
Amazon S3가 복제를 위해 소스 버킷의 객체에 액세스할 수 없습니다. 소스 버킷에 대한 s3:GetObjectVersionForReplication 권한이 누락되었을 수 있습니다. |
SrcGetRetentionNotPermitted |
Amazon S3가 S3 객체 잠금 보존 기간 정보에 액세스할 수 없습니다. |
SrcGetTaggingNotPermitted |
Amazon S3가 소스 버킷의 객체 태그 정보에 액세스할 수 없습니다. 소스 버킷에 대한 s3:GetObjectVersionTagging 권한이 누락되었을 수 있습니다. |
SrcHeadObjectNotPermitted |
Amazon S3가 소스 버킷에서 객체 메타데이터를 검색할 수 없습니다. 소스 버킷에 대한 s3:GetObjectVersionForReplication 권한이 누락되었을 수 있습니다. |
SrcKeyNotFound |
Amazon S3가 복제할 소스 객체 키를 찾을 수 없습니다. 복제가 완료되기 전에 소스 객체가 삭제되었을 수 있습니다. |
SrcKmsKeyInvalidState |
소스 버킷의 AWS KMS 키가 유효하지 않은 상태입니다. 필요한 AWS KMS 키를 검토하고 활성화합니다. AWS KMS 키 관리에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 AWS KMS 키의 키 상태를 참조하세요. |
SrcObjectNotEligible |
일부 객체가 복제 요건을 충족하지 않습니다. 이는 객체의 스토리지 클래스 또는 객체 태그가 복제 구성과 일치하지 않기 때문일 수 있습니다. |
SrcObjectNotFound |
소스 객체가 존재하지 않습니다. |
SrcReplicationNotPending |
Amazon S3에서 이미 이 객체를 복제했습니다. 이 객체가 더 이상 복제 보류 중이 아닙니다. |
SrcVersionNotFound |
Amazon S3가 복제할 소스 객체 버전을 찾을 수 없습니다. 복제가 완료되기 전에 소스 객체 버전이 삭제되었을 수 있습니다. |