기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon EventBridge에서 이벤트 아카이브 생성
EventBridge에서 아카이브를 생성할 때 [이벤트 패턴](eb-event-patterns.md)을 지정하여 아카이브로 전송할 이벤트를 결정할 수 있습니다. EventBridge는 이벤트 패턴과 일치하는 이벤트를 아카이브로 보냅니다. 또한 이벤트가 폐기되기 전에 아카이브에 이벤트를 저장하도록 보존 기간을 설정합니다.
[이벤트 버스 생성](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html)의 일부로 아카이브를 생성할 수도 있습니다. 아카이브가 생성되면 [업데이트](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html)할 수 있지만 이러한 아카이브에는 무기한 보존 정책이 있으며 이벤트 필터가 없습니다.
**Topics**
+ [아카이브 정의](#eb-create-archive-define)
+ [이벤트 패턴 구축(선택 사항)](#eb-create-archive-event-pattern)
## 아카이브 정의
먼저 아카이브의 이름과 설명을 입력하고 이벤트를 수신하는 이벤트 버스를 지정합니다. 선택적으로 아카이브에 이벤트를 유지할 기간을 설정할 수도 있습니다.
**아카이브를 정의하려면**
1. Amazon EventBridge 콘솔([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/))을 엽니다.
1. 소스 이벤트 버스로 이동하거나 아카이브를 직접 생성합니다.
+ 탐색 창에서 **이벤트 버스**를 선택합니다.
이벤트 버스 세부 정보 페이지에서 **아카이브** 탭을 선택합니다.
+ 탐색 창에서 **아카이브**를 선택합니다.
1. **아카이브 생성**을 선택합니다.
1. **아카이브 세부 정보**에서 아카이브에 대한 이름과 선택적으로 설명을 입력합니다.
이 이름은 선택한 리전의 계정에 대해 고유해야 합니다. 아카이브를 생성한 후에는 이름을 변경할 수 없습니다.
1. **소스**의 경우 아카이브로 전송할 이벤트를 내보내는 이벤트 버스를 선택합니다.
기존 이벤트 버스 세부 정보 페이지에서 이동한 경우 해당 이벤트 버스의 이름이 기본적으로 표시됩니다.
아카이브를 생성한 후에는 소스 이벤트 버스를 변경할 수 없습니다.
1. **유지 기간**에 아카이브에 이벤트를 유지할 기간을 지정합니다.
+ 이벤트를 아카이브에 보존하고 삭제하지 않으려면 **무기한**을 선택합니다.
+ 설정된 유지 기간에 EventBridge가 아카이브에서 이벤트를 삭제해야 하는 일수를 입력합니다.
1. **암호화**의 경우, 아카이브에 저장된 이벤트를 암호화할 때 사용할 EventBridge의 KMS 키를 선택합니다.
**중요**
EventBridge가 소스 이벤트 버스를 암호화하는 데 고객 관리형 키를 사용하도록 지정한 경우 이벤트 버스의 모든 아카이브에도 고객 관리형 키를 지정하는 것이 좋습니다.
+ EventBridge가 AWS 소유 키를 사용하여 데이터를 암호화하도록 하려면 **AWS 소유 키 사용**을 선택합니다.
이 AWS 소유 키는 여러 AWS 계정에서 사용하기 위해 EventBridge가 소유하고 관리하는 KMS 키입니다. 일반적으로 리소스를 보호하는 암호화 키를 감사하거나 제어할 필요가 없을 경우, AWS 소유 키를 선택하는 것이 좋습니다.
이 값이 기본값입니다.
+ EventBridge에 **고객 관리형 키 사용**을 선택하여 지정하거나 생성한 고객 관리형 키를 사용하여 데이터를 암호화합니다.
고객 관리형 키는 사용자가 생성, 소유 및 관리하는 AWS 계정의 KMS 키입니다. 이러한 KMS 키를 완전히 제어할 수 있습니다.
1. 기존 고객 관리형 키를 지정하거나 **새 KMS 키 생성 />**을 선택합니다.
EventBridge는 키 상태뿐만 아니라, 지정된 고객 관리형 키와 연결된 모든 키 별칭도 표시합니다.
1. **다음**을 선택합니다.
## 이벤트 패턴 구축(선택 사항)
다음으로 선택적 단계로 이벤트 패턴을 구축하여 EventBridge가 아카이브로 보내는 이벤트를 필터링할 수 있습니다. 이렇게 하려면 이벤트 소스를 지정하고, 이벤트 패턴의 기준을 선택하고, 일치시킬 속성과 값을 정의합니다. 또한 JSON으로 이벤트 패턴을 생성하고 샘플 이벤트와 비교하여 테스트할 수 있습니다.
이벤트 패턴에 대한 자세한 내용은 [](eb-event-patterns.md) 섹션을 참조하세요.
**이벤트 패턴을 작성하려면**
1. **이벤트 소스**에서 **AWS 이벤트 또는 EventBridge 파트너 이벤트**를 선택합니다.
1. (선택 사항) **샘플 이벤트** 섹션에서 이벤트 패턴을 테스트할 **샘플 이벤트 유형**을 선택합니다.
다음 샘플 이벤트 유형을 사용할 수 있습니다.
+ **AWS 이벤트 **- 지원되는 AWS 서비스에서 발생한 이벤트 중에서 선택합니다.
+ **EventBridge 파트너 이벤트** - Salesforce와 같이 EventBridge를 지원하는 타사 서비스에서 발생한 이벤트 중에서 선택합니다.
+ **내 이벤트 입력** - JSON 텍스트로 자체 이벤트를 입력합니다.
AWS 또는 파트너 이벤트를 시작점으로 삼아 사용자 지정 이벤트를 자체적으로 만들 수도 있습니다.
1. **AWS 이벤트** 또는 **EventBridge 파트너 이벤트**를 선택합니다.
1. **샘플 이벤트** 드롭다운을 이용해 사용자 지정 이벤트의 시작점으로 사용할 이벤트를 선택합니다.
EventBridge는 샘플 이벤트를 표시합니다.
1. **복사**를 선택합니다.
1. **이벤트 유형**에서 **내 이벤트 입력**을 선택합니다.
1. JSON 편집 창에서 샘플 이벤트 구조를 삭제하고 AWS 또는 파트너 이벤트를 대신 붙여넣습니다.
1. 이벤트 JSON을 편집하여 자체 샘플 이벤트를 생성합니다.
1. **생성 방법**을 선택합니다. EventBridge 스키마 또는 템플릿에서 이벤트 패턴을 생성하거나 사용자 지정 이벤트 패턴을 생성할 수 있습니다.
------
#### [ Existing schema ]
기존 EventBridge 스키마를 사용하여 이벤트 패턴을 생성하려면 다음을 수행하세요.
1. **생성 방법** 섹션의 **메서드**에서 **스키마 사용**을 선택합니다.
1. **이벤트 패턴** 섹션의 **스키마 유형**에서 **스키마 레지스트리에서 스키마 선택**을 선택합니다.
1. **스키마 레지스트리**의 경우 드롭다운 상자를 선택하고 스키마 레지스트리 이름(예: `aws.events`)을 입력합니다. 표시되는 드롭다운 목록에서 옵션을 선택할 수도 있습니다.
1. **스키마**의 경우 드롭다운 상자를 선택하고 사용할 스키마 이름을 입력합니다. 예를 들어 `aws.s3@ObjectDeleted`입니다. 표시되는 드롭다운 목록에서 옵션을 선택할 수도 있습니다.
1. **모델** 섹션에서 속성 옆에 있는 **편집** 버튼을 선택하여 해당 속성을 엽니다. 필요에 따라 **관계** 및 **값** 필드를 설정한 다음, **설정**을 선택하여 속성을 저장합니다.
**참고**
속성 정의에 대한 자세한 내용을 보려면 속성 이름 옆에 있는 **정보** 아이콘을 선택하세요. 이벤트에서 속성 특성을 설정하는 방법에 대한 참조를 보려면 속성 특성 대화 상자의 **참고** 섹션을 엽니다.
속성 특성을 삭제하려면 해당 속성의 **편집** 버튼을 선택한 다음, **지우기**를 선택합니다.
1. 이벤트 패턴을 JSON 텍스트로 생성하고 검증하려면 **JSON으로 이벤트 패턴 생성**을 선택합니다.
1. (선택 사항) 테스트 패턴과 비교하여 샘플 이벤트를 테스트하려면 **테스트 패턴**을 선택합니다.
EventBridge는 샘플 이벤트가 이벤트 패턴과 일치하는지 여부를 나타내는 메시지 상자를 표시합니다.
다음 옵션 중 하나를 선택할 수도 있습니다.
+ **복사** - 이벤트 패턴을 디바이스의 클립보드에 복사합니다.
+ **정리** - 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.
------
#### [ Custom schema ]
사용자 지정 스키마를 작성하고 이벤트 패턴으로 변환하려면 다음을 수행하세요.
1. **생성 방법** 섹션의 **메서드**에서 **스키마 사용**을 선택합니다.
1. **이벤트 패턴** 섹션의 **스키마 유형**에서 **스키마 입력**을 선택합니다.
1. 텍스트 상자에 스키마를 입력합니다. 스키마의 형식을 유효한 JSON 텍스트로 지정해야 합니다.
1. **모델** 섹션에서 속성 옆에 있는 **편집** 버튼을 선택하여 해당 속성을 엽니다. 필요에 따라 **관계** 및 **값** 필드를 설정한 다음, **설정**을 선택하여 속성을 저장합니다.
**참고**
속성 정의에 대한 자세한 내용을 보려면 속성 이름 옆에 있는 **정보** 아이콘을 선택하세요. 이벤트에서 속성 특성을 설정하는 방법에 대한 참조를 보려면 속성 특성 대화 상자의 **참고** 섹션을 엽니다.
속성 특성을 삭제하려면 해당 속성의 **편집** 버튼을 선택한 다음, **지우기**를 선택합니다.
1. 이벤트 패턴을 JSON 텍스트로 생성하고 검증하려면 **JSON으로 이벤트 패턴 생성**을 선택합니다.
1. (선택 사항) 테스트 패턴과 비교하여 샘플 이벤트를 테스트하려면 **테스트 패턴**을 선택합니다.
EventBridge는 샘플 이벤트가 이벤트 패턴과 일치하는지 여부를 나타내는 메시지 상자를 표시합니다.
다음 옵션 중 하나를 선택할 수도 있습니다.
+ **복사** - 이벤트 패턴을 디바이스의 클립보드에 복사합니다.
+ **정리** - 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.
------
#### [ Event pattern ]
JSON 형식의 사용자 지정 이벤트 패턴을 작성하려면 다음을 수행하세요.
1. **생성 방법** 섹션의 **메서드**에서 **사용자 지정 패턴(JSON 편집기)**을 선택합니다.
1. **이벤트 패턴**의 경우 JSON 형식 텍스트로 사용자 지정 이벤트 패턴을 입력합니다.
1. (선택 사항) 테스트 패턴과 비교하여 샘플 이벤트를 테스트하려면 **테스트 패턴**을 선택합니다.
EventBridge는 샘플 이벤트가 이벤트 패턴과 일치하는지 여부를 나타내는 메시지 상자를 표시합니다.
다음 옵션 중 하나를 선택할 수도 있습니다.
+ **복사** - 이벤트 패턴을 디바이스의 클립보드에 복사합니다.
+ **정리** - 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.
+ **이벤트 패턴 양식** - 패턴 빌더에서 이벤트 패턴을 엽니다. 패턴 빌더에서 패턴을 있는 그대로 렌더링할 수 없는 경우 EventBridge는 패턴 빌더를 열기 전에 경고를 표시합니다.
------
1. **아카이브 생성**을 선택합니다.
이벤트가 아카이브에 성공적으로 전송되었는지 확인하려면 EventBridge API의 [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) 작업을 사용하여 `EventCount`이(가) 아카이브의 이벤트 수를 반영하는지 확인할 수 있습니다. 값이 0이면 아카이브에 이벤트가 없는 것입니다.