기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Enhanced Builder를 사용하여 규칙 생성
<a name="eb-create-rule-visual"></a>

## 사전 조건
<a name="eb-create-rule-prerequisites"></a>

시작하기 전에 다음을 갖추었는지 확인하세요.
+ Amazon EventBridge 콘솔에 대한 액세스
+ EventBridge 규칙을 생성하기 위한 적절한 IAM 권한
+ 이벤트 기반 아키텍처에 대한 기본 이해

## 개요
<a name="eb-create-rule-overview"></a>

EventBridge에서 수신한 이벤트에 대해 조치를 취하려면 규칙을 생성하면 됩니다. 이벤트가 규칙에 정의된 이벤트 패턴과 일치하면 EventBridge는 이벤트를 지정된 대상으로 보냅니다.

이 주제에서는 EventBridge가 지정된 이벤트 버스로 전송되는 이벤트를 일치시키는 데 사용하는 규칙을 생성하는 방법을 안내합니다.

EventBridge 규칙 생성에는 네 가지 주요 단계가 포함됩니다.

1. 처리할 이벤트 선택

1. 이벤트 필터링 및 테스트 구성

1. 대상 선택 및 구성

1. 규칙 설정 구성

## 이벤트 선택
<a name="eb-create-rule-source"></a>

먼저 대상으로 전송할 이벤트를 선택합니다.

**이벤트를 선택하려면**

1. Amazon EventBridge 콘솔([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/))을 엽니다.

1. 탐색 창에서 **규칙(Rules)**을 선택한 후 **규칙 생성(Create rule)**을 선택합니다.

1. 규칙 빌더 선택 페이지에서 **향상된 빌더를** 선택합니다.

   Enhanced Builder는 이벤트 및 대상을 드래그 앤 드롭하여 규칙 및 대상을 빌드할 수 있는 시각적 캔버스를 제공합니다. 대신 JSON 패턴 및 구성을 사용하려면 [규칙 생성(고급 빌더)을](eb-create-rule-wizard.md) 참조하세요.

1. **이벤트** 탭에서 대상으로 전송할 이벤트를 찾습니다.

   1. **AWS 서비스 이벤트** 또는 **사용자 지정 이벤트를** 선택합니다.

   1. 검색 상자를 사용하거나 이벤트 목록을 검색하여 대상에 보낼 이벤트를 찾습니다.

   1. 하나 이상의 이벤트를 **빌드** 캔버스로 끌어 **이벤트 트리거**에 놓습니다.

   EventBridge에 **이벤트 트리거 섹션이** 표시됩니다. 이 섹션에는 다음 내용이 포함되어 있습니다.
   + **이벤트** - 선택한 이벤트를 나열합니다.
   + **스키마** - 사용 가능한 경우 선택한 이벤트의 스키마를 표시합니다.

     **스키마**에는 세 개의 탭이 있습니다.
     + **트리**: 이벤트 스키마의 트리 보기입니다.
     + **코드**: Open API 사양 또는 JSON 형식의 이벤트 스키마입니다.
     + **정보**: 스키마에 대한 개요 정보입니다.
   + 가능한 경우 선택한 **이벤트**의 샘플을 표시하는 샘플 이벤트입니다.
   + **이벤트 패턴(필터)** - 선택한 모든 이벤트를 선택하는 이벤트 패턴을 포함합니다.

## 원하는 것만 전송하도록 이벤트 필터링
<a name="eb-create-rule-event-pattern-visual"></a>

특정 유형의 *모든* 이벤트를 대상으로 전송하고 싶지 않을 수 있습니다. 관심 있는 속성과 값이 포함된 이벤트만 선택하도록 이벤트 패턴을 보다 구체적으로 만들 수 있습니다.

### 이벤트 패턴 편집(선택 사항)
<a name="eb-create-rule-event-pattern-steps"></a>

**이벤트 트리거** 창에서 다음 두 가지 방법으로 이벤트 패턴을 빌드할 수 있습니다.
+ 시각적으로 **스키마** 트리 보기 사용
+ **이벤트 패턴** 창에서 JSON을 직접 편집하여

**스키마 트리 보기를 사용하여 이벤트 패턴을 편집하려면**

1. **스키마** 창의 **트리** 탭을 선택합니다.

1. 필터를 추가하고 편집하여 이벤트 패턴을 빌드합니다.

   1. 이벤트 패턴에 필터로 추가할 속성 옆에 있는 필터 아이콘을 선택합니다.

   1. 드롭다운 목록에서 비교 연산자를 선택합니다.

      비교 연산자에 대한 자세한 내용은 [이벤트 패턴 생성을](eb-create-pattern-operators.md) 참조하세요.

   1. 일치시킬 값을 입력합니다.

   1. 확인 표시를 클릭하여 완료합니다.

   EventBridge는 생성한 필터를 **이벤트 패턴** 창의 JSON에 추가합니다.

1. 원하는 모든 이벤트 속성과 일치하는 이벤트 패턴을 구성할 때까지 필터를 추가합니다.

### 이벤트 패턴 테스트
<a name="eb-create-rule-event-pattern-test"></a>

원하는 모든 이벤트 속성과 일치하는 이벤트 패턴을 구성한 후 이벤트 패턴이 예상대로 작동하는지 테스트합니다.

#### 이벤트 패턴 테스트(선택 사항)
<a name="eb-create-rule-event-pattern-test-steps"></a>

1. 테스트할 샘플 이벤트를 선택하거나 자체 이벤트를 사용합니다.
   + **제공된 샘플 이벤트 사용**

     1. **제공된 샘플 이벤트 사용을** 선택합니다.

     1. **샘플 트리거 이벤트**의 드롭다운 목록에서 테스트에 사용할 이벤트를 선택합니다.
   + **자체 이벤트 사용**

     1. **자체 이벤트 사용**을 선택합니다.

        EventBridge는 빈 `details` 요소가 있는 일반 이벤트를 표시합니다.

     1. 이벤트 JSON을 편집하여 이벤트 패턴을 테스트할 이벤트를 생성합니다.
**작은 정보**  
제공된 샘플 이벤트를 시작점으로 삼아 테스트에 사용할 사용자 지정 이벤트를 생성할 수 있습니다.  
**제공된 샘플 이벤트 사용**을 선택하고 **샘플 트리거 이벤트**에서 이벤트를 선택한 다음 **복사**를 선택합니다.
**자체 이벤트 사용**을 선택합니다.
창에서 전체 이벤트를 선택하고 샘플 이벤트를 그 위에 붙여 넣습니다.
원하는 대로 이벤트를 편집합니다.

1. **테스트 실행**을 선택합니다.

   EventBridge는 테스트 이벤트가 이벤트 패턴과 일치하는지 여부를 나타내는 메시지를 표시합니다.

## 대상 선택
<a name="eb-create-rule-target-visual"></a>

한 개(최대 5개)의 대상을 **빌드** 캔버스로 끌어**서 대상**에 놓아 지정된 이벤트 패턴과 일치하는 이벤트를 수신합니다. 대상에는 다음이 포함될 수 있습니다.
+ 동일하거나 다른의 기타 EventBridge 이벤트 버스 AWS 계정
+ Salesforce와 같은 SaaS 파트너를 포함한 EventBridge API 대상
+ Amazon SQS 대기열 또는 Amazon SNS 주제와 같은 다양한 AWS 서비스 리소스

**대상을 선택하려면**

1. 대상 창에서 **대상** 유형을 선택하고 빌드 캔버스의 **대상** 셰이프에 놓습니다.

   EventBridge는 선택한 **대상** 유형에 따라 적용 가능한 구성 옵션과 함께 빌드의 대상 섹션을 표시합니다.
**작은 정보**  
둘 이상의 대상을 지정한 경우 대상 셰이프를 선택하면 해당 대상의 구성 섹션이 표시됩니다.

1. 대상 유형에 따라 대상을 구성합니다. 자세한 구성 단계는 [EventBridge 대상을 참조하세요](eb-targets.md).

### 대상으로 전송되는 이벤트 데이터 사용자 지정
<a name="eb-create-rule-target-transform"></a>

EventBridge 이벤트 버스 또는 EventBridge API 대상 이외의 대상을 선택하는 경우 실제로 대상에 전송되는 데이터를 사용자 지정할 수 있습니다.

#### 전송된 이벤트 데이터 변환 또는 교체(선택 사항)
<a name="eb-create-rule-target-transform-steps"></a>

1. 빌드 디자인 캔버스에서 **대상** 셰이프의 **입력 변환** 아이콘을 선택합니다.

   EventBridge는 **입력 변환** 섹션을 표시합니다.

1. **입력 변환 구성**에서 **활성화**를 선택합니다.

1. 변환 방법을 선택하여 일치하는 이벤트를 위해 대상으로 전송되는 텍스트를 사용자 지정하는 방법을 선택합니다.
   + **일치하는 이벤트의 일부** — EventBridge는 원본 소스 이벤트의 지정된 부분만 대상에 보냅니다.
   + **상수(JSON 텍스트)** - EventBridge는 지정된 JSON 텍스트만 대상으로 전송합니다. 원본 소스 이벤트의 어떤 부분도 전송되지 않습니다.
   + **입력 변환기** - EventBridge가 대상으로 전송할 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 [대상 입력 변환을 참조하세요](eb-transform-target-input.md).

## 규칙 구성
<a name="eb-create-rule-configure"></a>

마지막으로 규칙을 구성하고 생성합니다.

**규칙을 구성하려면(콘솔)**

1. **구성**을 선택합니다.

1. 규칙의 **이름**을 입력하고 선택적으로 **설명**을 입력합니다.

   규칙은 동일한 및 동일한 이벤트 버스의 다른 규칙 AWS 리전 과 동일한 이름을 가질 수 없습니다.

1. **이벤트 버스**에서 이 규칙과 연결할 이벤트 버스를 선택합니다.

   이 규칙이 자신의 계정에서 발생하는 이벤트와 일치하도록 하려면 **AWS 기본 이벤트 버스(default event bus)**를 선택합니다. 계정 AWS 서비스 의가 이벤트를 보내면 항상 계정의 기본 이벤트 버스로 이동합니다.

1. 규칙이 생성되는 즉시 활성화하려면 **활성화**에서 **활성화를** 활성화합니다.

1. (선택 사항)규칙에 대해 하나 이상의 태그를 입력하세요. 자세한 내용은 [Amazon EventBridge에서 리소스 태그 지정](eb-tagging.md) 단원을 참조하십시오.

1. **생성(Create)**을 선택합니다.

## 다음 단계
<a name="eb-create-rule-next-steps"></a>

규칙을 생성한 후 다음을 수행할 수 있습니다.
+ [지표를 사용하여 규칙 성능 모니터링](eb-monitoring.md)
+ [샘플 이벤트로 규칙 테스트](eb-event-pattern-sandbox.md)
+ [필요에 따라 이벤트 패턴 수정](eb-event-patterns.md)
+ [기존 규칙에 대상 추가](eb-targets.md)

## 추가 리소스
<a name="eb-create-rule-additional-resources"></a>

EventBridge 규칙에 대한 자세한 내용은 다음을 참조하세요.
+ [EventBridge 규칙 개요](eb-rules.md)
+ [이벤트 패턴 생성](eb-event-patterns.md)
+ [EventBridge 대상](eb-targets.md)
+ [EventBridge 규칙 문제 해결](eb-troubleshooting.md)