# EventBridge 사용
<a name="EventBridge"></a>

Amazon S3는 버킷에서 특정 이벤트가 발생할 때마다 Amazon EventBridge에 이벤트를 보낼 수 있습니다. 다른 대상과 달리 전송할 이벤트 유형을 선택할 필요가 없습니다. EventBridge가 사용 설정되면 아래의 모든 이벤트가 EventBridge로 전송됩니다. EventBridge 규칙을 사용하여 이벤트를 추가 대상으로 라우팅할 수 있습니다. 다음은 Amazon S3가 EventBridge에 보내는 이벤트 목록입니다.


|  이벤트 유형 |  설명  | 
| --- | --- | 
|  *객체 생성됨(Object Created*  |  객체가 생성되었습니다. 이벤트 메시지 구조의 이유 필드는 객체 생성에 사용된 S3 API([https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) 또는 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html))를 나타냅니다.  | 
|  *객체 삭제됨(DeleteObject)(Object Deleted (DeleteObject)*) *객체 삭제됨(수명 주기 만료)(Object Deleted (Lifecycle expiration)*)  |  객체가 삭제되었습니다. S3 API 직접 호출을 사용하여 객체를 삭제하면 이유 필드가 DeleteObject로 설정됩니다. S3 수명 주기 만료 규칙에 의해 객체가 삭제되면 이유 필드가 수명 주기 만료(Lifecycle Expiration)로 설정됩니다. 자세한 내용은 [객체 만료](lifecycle-expire-general-considerations.md) 섹션을 참조하세요. 버전이 지정되지 않은 객체가 삭제되거나 버전이 관리되는 객체가 영구적으로 삭제되면 deletion-type 필드가 Permanently Deleted로 설정됩니다. 버전이 관리되는 객체에 대해 삭제 마커가 생성되면 `deletion-type` 필드가 Delete Marker Created로 설정됩니다. 자세한 내용은 [버전 관리가 사용 설정된 버킷에서 객체 버전 삭제](DeletingObjectVersions.md) 섹션을 참조하세요.  | 
|  *객체 복원 시작됨*  |  객체 복원이 S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스나 S3 Intelligent-Tiering Archive Access 또는 Deep Archive Access 계층에서 시작되었습니다. 자세한 내용은 [아카이브된 객체 작업](archived-objects.md) 섹션을 참조하세요.  | 
|  *객체 복원 완료됨(Object Restore Completed*  |  객체 복원이 완료되었습니다.  | 
|  *객체 복원 만료됨(Object Restore Expired*  |  S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive에서 복원된 객체의 임시 사본이 만료되어 삭제되었습니다.  | 
|  *객체 스토리지 클래스 변경됨(Object Storage Class Changed*  |  객체가 다른 스토리지 클래스로 전환되었습니다. 자세한 내용은 [Amazon S3 수명 주기를 사용하여 객체 전환](lifecycle-transition-general-considerations.md) 섹션을 참조하세요.  | 
|  *객체 액세스 계층 변경됨(Object Access Tier Changed*  |  객체가 S3 Intelligent-Tiering Archive Access 계층 또는 Deep Archive Access 계층으로 전환되었습니다. 자세한 내용은 [Amazon S3 Intelligent-Tiering을 사용한 스토리지 비용 관리](intelligent-tiering.md) 섹션을 참조하세요.  | 
|  *객체 ACL 업데이트됨(Object ACL Updated*  |  `PutObjectAcl`을 사용하여 객체의 액세스 제어 목록(ACL)이 설정되었습니다. 요청으로 인해 객체의 ACL이 변경되지 않으면 이벤트가 생성되지 않습니다. 자세한 내용은 [ACL(액세스 제어 목록) 개요](acl-overview.md) 섹션을 참조하세요.  | 
|  *객체 태그 추가됨(Object Tags Added*  |  `PutObjectTagging`을 사용하여 태그 집합이 객체에 추가되었습니다. 자세한 내용은 [태그를 사용하여 객체 분류](object-tagging.md) 섹션을 참조하세요.  | 
|  *객체 태그 삭제됨(Object Tags Deleted*  |  `DeleteObjectTagging`을 사용하여 객체에서 모든 태그가 제거되었습니다. 자세한 내용은 [태그를 사용하여 객체 분류](object-tagging.md) 섹션을 참조하세요.  | 

**참고**  
Amazon S3 이벤트 유형이 EventBridge 이벤트 유형에 매핑되는 방법에 대한 자세한 내용은 [Amazon EventBridge 매핑 및 문제 해결](ev-mapping-troubleshooting.md) 섹션을 참조하십시오.

EventBridge와 함께 Amazon S3 이벤트 알림을 사용하여 버킷에서 이벤트가 발생할 때 조치를 취하는 규칙을 작성할 수 있습니다. 예를 들어 알림이 전송되도록 할 수 있습니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [EventBridge란?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)을 참조하세요.

EventBridge API를 사용하여 상호 작용할 수 있는 작업 및 데이터 유형에 대한 자세한 내용은 **Amazon EventBridge API 참조의 [Amazon EventBridge API 참조](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html)를 참조하세요.

요금에 대한 자세한 내용은 [Amazon EventBridge 요금](https://aws.amazon.com/eventbridge/pricing)을 참조하십시오.

**Topics**
+ [Amazon EventBridge 권한](ev-permissions.md)
+ [Amazon EventBridge 사용 설정](enable-event-notifications-eventbridge.md)
+ [EventBridge 이벤트 메시지 구조](ev-events.md)
+ [Amazon EventBridge 매핑 및 문제 해결](ev-mapping-troubleshooting.md)