EventBridge 사용
EventBridge 사용
버킷에서 특정 이벤트가 발생할 때마다 Amazon S3가 Amazon EventBridge로 이벤트를 보낼 수 있어요. 다른 대상과 달리 전달할 이벤트 유형을 선택할 필요가 없어요. EventBridge가 활성화된 뒤에는 아래의 모든 이벤트가 EventBridge로 전송돼요. EventBridge 규칙을 사용해 이벤트를 추가 대상으로 라우팅할 수 있어요.
본문
다음은 Amazon S3가 EventBridge로 보내는 이벤트 목록이에요.
| 이벤트 유형 | 설명 |
|---|---|
| Object Created (객체 생성) | 객체가 생성됐어요. 이벤트 메시지 구조의 reason 필드는 객체를 만드는 데 사용된 S3 API를 나타내요: PutObject, POST Object, CopyObject, 또는 CompleteMultipartUpload. |
| Object Deleted (DeleteObject) / Object Deleted (Lifecycle expiration) | 객체가 삭제됐어요. S3 API 호출로 객체가 삭제되면 reason 필드가 DeleteObject로 설정돼요. S3 Lifecycle 만료 규칙으로 객체가 삭제되면 reason 필드가 Lifecycle Expiration으로 설정돼요. 자세한 내용은 객체 만료를 참고하세요. 버전 관리가 없는 객체가 삭제되거나 버전화된 객체가 영구 삭제되면 deletion-type 필드가 Permanently Deleted로 설정돼요. 버전화된 객체에 대해 삭제 마커가 생성되면 deletion-type 필드가 Delete Marker Created로 설정돼요. 자세한 내용은 버전 관리가 활성화된 버킷에서 객체 버전 삭제를 참고하세요. |
| Object Restore Initiated (객체 복원 시작) | S3 Glacier Flexible Retrieval이나 S3 Glacier Deep Archive 스토리지 클래스, 또는 S3 Intelligent-Tiering Archive Access나 Deep Archive Access 티어에서 객체 복원이 시작됐어요. 자세한 내용은 아카이브된 객체 작업을 참고하세요. |
| Object Restore Completed (객체 복원 완료) | 객체 복원이 완료됐어요. |
| Object Restore Expired (객체 복원 만료) | S3 Glacier Flexible Retrieval이나 S3 Glacier Deep Archive에서 복원된 객체의 임시 복사본이 만료되어 삭제됐어요. |
| Object Storage Class Changed (객체 스토리지 클래스 변경) | 객체가 다른 스토리지 클래스로 전환됐어요. 자세한 내용은 Amazon S3 Lifecycle로 객체 전환을 참고하세요. |
| Object Access Tier Changed (객체 액세스 티어 변경) | 객체가 S3 Intelligent-Tiering Archive Access 티어나 Deep Archive Access 티어로 전환됐어요. 자세한 내용은 Amazon S3 Intelligent-Tiering으로 스토리지 비용 관리를 참고하세요. |
| Object ACL Updated (객체 ACL 업데이트) | PutObjectAcl로 객체의 액세스 제어 목록(ACL)이 설정됐어요. 요청이 객체의 ACL에 변화를 주지 않으면 이벤트가 생성되지 않아요. 자세한 내용은 액세스 제어 목록(ACL) 개요를 참고하세요. |
| Object Tags Added (객체 태그 추가) | PutObjectTagging으로 객체에 태그 집합이 추가됐어요. 자세한 내용은 객체 태그 지정을 참고하세요. |
| Object Tags Deleted (객체 태그 삭제) | DeleteObjectTagging으로 객체에서 모든 태그가 제거됐어요. 자세한 내용은 객체 태그 지정을 참고하세요. |
| Object Annotation Created (객체 어노테이션 생성) | PutObjectAnnotation으로 객체에 어노테이션이 생성되거나 업데이트됐어요. 자세한 내용은 객체 어노테이션을 참고하세요. |
| Object Annotation Removed (객체 어노테이션 제거) | DeleteObjectAnnotation으로 객체에서 어노테이션이 삭제됐어요. 자세한 내용은 객체 어노테이션을 참고하세요. |
| Object Retention Updated (객체 보존 업데이트) | Amazon S3는 PutObjectRetention 요청을 통해 객체의 Object Lock 보존 설정이 변경되면 이 이벤트를 보내요. 여기에는 고정 또는 가변 보존 설정, 이벤트 홀드 해제, 이벤트 홀드 기간 수정, 보존-만료일(retain-until-date) 설정 또는 연장이 포함돼요. |
Amazon S3 이벤트 유형이 EventBridge 이벤트 유형에 어떻게 매핑되는지에 대한 자세한 내용은 Amazon EventBridge 매핑 및 문제 해결을 참고하세요.
Amazon S3 이벤트 알림을 EventBridge와 함께 사용해 버킷에서 이벤트가 발생할 때 조치를 취하는 규칙을 작성할 수 있어요. 예를 들어 알림을 보내도록 할 수 있어요. 자세한 내용은 Amazon EventBridge 사용 안내서의 EventBridge란 무엇인가요?를 참고하세요. EventBridge API로 상호작용할 수 있는 작업과 데이터 유형에 대한 자세한 내용은 Amazon EventBridge API Reference의 Amazon EventBridge API Reference를 참고하세요. 요금에 대한 정보는 Amazon EventBridge 요금을 참고하세요.