Amazon의 이벤트에 반응하는 규칙 생성 EventBridge - Amazon EventBridge
규칙 정의이벤트 패턴 작성대상 선택태그 구성 및 규칙 검토

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

Amazon의 이벤트에 반응하는 규칙 생성 EventBridge

규칙을 생성하여 EventBridge Amazon에서 수신한 이벤트에 대해 조치를 취할 수 있습니다. 이벤트가 규칙에 정의된 이벤트 패턴과 일치하면 이벤트를 지정된 대상으로 EventBridge 전송하고 규칙에 정의된 작업을 트리거합니다.

다음 비디오에서는 다양한 종류의 규칙을 만들고 테스트하는 방법을 살펴봅니다.

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

규칙 정의

먼저 규칙을 식별할 수 있도록 규칙의 이름과 설명을 입력합니다. 또한 규칙이 이벤트 패턴에 맞는 이벤트를 찾는 이벤트 버스를 정의해야 합니다.

규칙 세부 정보를 정의하려면

  1. 에서 Amazon EventBridge 콘솔을 엽니다 https://console.aws.amazon.com/events/.

  2. 탐색 창에서 규칙을 선택합니다.

  3. 규칙 생성을 선택합니다.

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

    규칙은 같은 이벤트 버스에 있는 다른 AWS 리전 규칙과 같은 이름을 가질 수 없습니다.

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

  6. 규칙 유형(Rule type)에서 이벤트 패턴이 있는 규칙(Rule with an event pattern)을 생성합니다.

  7. Next(다음)를 선택합니다.

이벤트 패턴 작성

다음으로 이벤트 패턴을 작성합니다. 이렇게 하려면 이벤트 소스를 지정하고, 이벤트 패턴의 기준을 선택하고, 일치시킬 속성과 값을 정의합니다. 에서 이벤트 패턴을 생성하여 샘플 JSON 이벤트와 비교하여 테스트할 수도 있습니다.

이벤트 패턴을 작성하려면

  1. 이벤트 소스의 경우 AWS 이벤트 또는 EventBridge 파트너 이벤트를 선택합니다.

  2. (선택 사항) 샘플 이벤트 섹션에서 이벤트 패턴을 테스트할 샘플 이벤트 유형을 선택합니다.

    다음 샘플 이벤트 유형을 사용할 수 있습니다.

    • AWS 이벤트 — support에서 생성된 이벤트 중에서 선택합니다. AWS 서비스

    • EventBridge 파트너 이벤트 — Salesforce와 같이 지원하는 EventBridge 타사 서비스에서 생성된 이벤트 중에서 선택합니다.

    • 내 이벤트 입력 — 원하는 이벤트를 텍스트로 입력합니다. JSON

      AWS 또는 파트너 이벤트를 출발점으로 삼아 나만의 맞춤 이벤트를 만들 수도 있습니다.

      1. AWS 이벤트 또는 EventBridge 파트너 이벤트를 선택하세요.

      2. 샘플 이벤트 드롭다운을 이용해 사용자 지정 이벤트의 시작점으로 사용할 이벤트를 선택합니다.

        EventBridge 샘플 이벤트를 표시합니다.

      3. 복사를 선택합니다.

      4. 이벤트 유형에서 내 이벤트 입력을 선택합니다.

      5. JSON편집 창에서 샘플 이벤트 구조를 삭제하고 그 자리에 AWS 또는 파트너 이벤트를 붙여넣습니다.

      6. 이벤트를 JSON 편집하여 자체 샘플 이벤트를 만드십시오.

  3. 생성 방법을 선택합니다. EventBridge 스키마 또는 템플릿에서 이벤트 패턴을 만들거나 사용자 지정 이벤트 패턴을 만들 수 있습니다.

    Existing schema

    기존 EventBridge 스키마를 사용하여 이벤트 패턴을 만들려면 다음과 같이 하십시오.

    1. 생성 방법 섹션의 메서드에서 스키마 사용을 선택합니다.

    2. 이벤트 패턴 섹션의 스키마 유형에서 스키마 레지스트리에서 스키마 선택을 선택합니다.

    3. 스키마 레지스트리의 경우 드롭다운 상자를 선택하고 스키마 레지스트리 이름(예: aws.events)을 입력합니다. 표시되는 드롭다운 목록에서 옵션을 선택할 수도 있습니다.

    4. 스키마의 경우 드롭다운 상자를 선택하고 사용할 스키마 이름을 입력합니다. 예: aws.s3@ObjectDeleted. 표시되는 드롭다운 목록에서 옵션을 선택할 수도 있습니다.

    5. 모델 섹션에서 속성 옆에 있는 편집 버튼을 선택하여 해당 속성을 엽니다. 필요에 따라 관계 및 값 필드를 설정한 다음, 설정을 선택하여 속성을 저장합니다.

      참고

      속성 정의에 대한 자세한 내용을 보려면 속성 이름 옆에 있는 정보 아이콘을 선택하세요. 이벤트에서 속성 특성을 설정하는 방법에 대한 참조를 보려면 속성 특성 대화 상자의 참고 섹션을 엽니다.

      속성 특성을 삭제하려면 해당 속성의 편집 버튼을 선택한 다음, 지우기를 선택합니다.

    6. 에서 JSON 이벤트 패턴 생성을 선택하여 이벤트 패턴을 JSON 텍스트로 생성하고 검증합니다.

    7. (선택 사항) 테스트 패턴과 비교하여 샘플 이벤트를 테스트하려면 테스트 패턴을 선택합니다.

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

      다음 옵션 중 하나를 선택할 수도 있습니다.

      • 복사 - 이벤트 패턴을 디바이스의 클립보드에 복사합니다.

      • Prettify — 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.

    Custom schema

    사용자 지정 스키마를 작성하고 이벤트 패턴으로 변환하려면 다음을 수행하세요.

    1. 생성 방법 섹션의 메서드에서 스키마 사용을 선택합니다.

    2. 이벤트 패턴 섹션의 스키마 유형에서 스키마 입력을 선택합니다.

    3. 텍스트 상자에 스키마를 입력합니다. 스키마를 유효한 JSON 텍스트로 포맷해야 합니다.

    4. 모델 섹션에서 속성 옆에 있는 편집 버튼을 선택하여 해당 속성을 엽니다. 필요에 따라 관계 및 값 필드를 설정한 다음, 설정을 선택하여 속성을 저장합니다.

      참고

      속성 정의에 대한 자세한 내용을 보려면 속성 이름 옆에 있는 정보 아이콘을 선택하세요. 이벤트에서 속성 특성을 설정하는 방법에 대한 참조를 보려면 속성 특성 대화 상자의 참고 섹션을 엽니다.

      속성 특성을 삭제하려면 해당 속성의 편집 버튼을 선택한 다음, 지우기를 선택합니다.

    5. 이벤트 패턴을 JSON JSON 텍스트로 생성하고 검증하려면 에서 이벤트 패턴 생성을 선택합니다.

    6. (선택 사항) 테스트 패턴과 비교하여 샘플 이벤트를 테스트하려면 테스트 패턴을 선택합니다.

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

      다음 옵션 중 하나를 선택할 수도 있습니다.

      • 복사 - 이벤트 패턴을 디바이스의 클립보드에 복사합니다.

      • Prettify — 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.

    Event pattern

    사용자 지정 이벤트 패턴을 JSON 형식으로 작성하려면 다음과 같이 하십시오.

    1. 생성 방법 섹션의 메서드에서 사용자 지정 패턴 (JSON편집기) 을 선택합니다.

    2. 이벤트 패턴의 경우 사용자 지정 이벤트 패턴을 JSON 서식이 지정된 텍스트로 입력합니다.

    3. (선택 사항) 테스트 패턴과 비교하여 샘플 이벤트를 테스트하려면 테스트 패턴을 선택합니다.

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

      다음 옵션 중 하나를 선택할 수도 있습니다.

      • 복사 - 이벤트 패턴을 디바이스의 클립보드에 복사합니다.

      • Prettify — 줄 바꿈, 탭, 공백을 추가하여 JSON 텍스트를 더 쉽게 읽을 수 있습니다.

      • 이벤트 패턴 양식 - 패턴 빌더에서 이벤트 패턴을 엽니다. 패턴 빌더에서 패턴을 있는 그대로 렌더링할 수 없는 경우 패턴 빌더가 열리기 전에 EventBridge 경고 메시지가 표시됩니다.

  4. Next(다음)를 선택합니다.

대상 선택

지정된 패턴과 일치하는 이벤트를 수신할 대상을 하나 이상 선택합니다. 대상에는 EventBridge 이벤트 버스, Salesforce와 같은 SaaS 파트너를 포함한 EventBridge API 목적지 등이 포함될 수 있습니다. AWS 서비스

대상을 선택하려면

  1. 대상 유형에서 다음 대상 유형 중 하나를 선택합니다.

    Event bus

    이벤트 버스를 선택하려면 EventBridge 이벤트 버스를 선택한 EventBridge 후 다음을 수행하십시오.

    API destination

    EventBridge API목적지를 사용하려면 EventBridge API목적지를 선택한 후 다음 중 하나를 수행하십시오.

    • 기존 대상을 사용하려면 기존 API 대상 사용을 선택합니다. API 그런 다음 드롭다운 목록에서 API 목적지를 선택합니다.

    • 새 목적지를 만들려면 새 API 목적지 만들기를 선택합니다. API 그런 다음 대상에 대해 다음 세부 정보를 제공합니다.

      • 이름 - 대상의 이름을 입력합니다.

        이름은 AWS 계정내에서 고유해야 합니다. 이름은 최대 64자까지 가능합니다. 유효한 문자는 A-Z, a-z, 0-9 및 . _ -(하이픈)입니다.

      • (선택 사항) 설명 – 대상에 대한 설명을 입력합니다.

        설명은 최대 512자까지 가능합니다.

      • API대상 엔드포인트 - 대상의 URL 엔드포인트입니다.

        엔드포인트는 로 URL 시작해야 합니다https. *를 경로 파라미터 와일드카드로 포함할 수 있습니다. 대상 HttpParameters 속성에서 경로 파라미터를 설정할 수 있습니다.

      • HTTP메서드 — 엔드포인트를 호출할 때 사용할 HTTP 방법을 선택합니다.

      • (선택 사항) 초당 간접 호출 속도 제한 — 이 대상에 대해 초당 허용되는 최대 간접 호출 수를 입력합니다.

        이 값은 0보다 커야 합니다. 기본적으로 이 값은 300으로 설정됩니다.

      • 연결 — 새 연결을 사용할지 기존 연결을 사용할지 선택합니다.

        • 기존 연결을 사용하려면 기존 연결 사용을 선택하고 드롭다운 목록에서 연결을 선택합니다.

        • 이 대상에 대한 새 연결을 만들려면 새 연결 만들기를 선택한 다음 연결의 이름, 대상 유형 및 권한 부여 유형을 정의합니다. 이 연결에 대한 설명(선택 사항)을 추가할 수도 있습니다.

    자세한 내용은 APIAmazon의 대상 목적지 EventBridge 단원을 참조하십시오.

    AWS 서비스

    를 사용하려면 AWS 서비스를 선택하고 AWS 서비스다음을 수행하십시오.

    1. 대상 선택에서 대상으로 사용할 AWS 서비스 를 선택합니다. 선택한 서비스에 대해 요청된 정보를 제공합니다.

      참고

      표시되는 필드는 선택한 서비스에 따라 달라집니다. 사용 가능한 대상에 대한 자세한 내용은 콘솔에서 EventBridge 사용 가능한 이벤트 버스 대상 섹션을 참조하세요.

  2. 많은 대상 유형의 경우 대상에 이벤트를 전송할 수 있는 권한이 EventBridge 필요합니다. 이러한 경우 규칙을 실행하는 데 필요한 IAM 역할을 생성할 EventBridge 수 있습니다.

    실행 역할에서는 다음 중 하나를 수행합니다.

    • 이 규칙의 새 실행 역할을 만들려면:

      1. 이 특정 리소스에 대해 새 역할 생성을 선택합니다.

      2. 이 실행 역할의 이름을 입력하거나 에서 생성한 이름을 사용하십시오 EventBridge.

    • 이 규칙에 기존 실행 역할을 사용하려면:

      1. 기존 역할 사용을 선택합니다.

      2. 드롭다운 목록에서 사용할 실행 역할의 이름을 입력하거나 선택합니다.

  3. (선택 사항) 추가 설정의 경우 대상 유형에 사용할 수 있는 선택적 설정을 지정합니다.

    Event bus

    (선택 사항) 데드레터 대기열의 경우 표준 Amazon 대기열을 데드레터 SQS 대기열로 사용할지 여부를 선택합니다. EventBridge 타겟에 성공적으로 전송되지 않은 경우 이 규칙과 일치하는 이벤트를 데드레터 대기열로 전송합니다. 다음 중 하나를 수행합니다.

    • 배달 못한 편지 대기열을 사용하지 않으려면 없음(None)을 선택합니다.

    • 현재 AWS 계정에서 데드레터 SQS 대기열로 사용할 Amazon 대기열 선택을 선택한 다음 드롭다운 목록에서 사용할 대기열을 선택합니다.

    • 다른 AWS 계정의 Amazon SQS 대기열을 데드레터 대기열로 선택을 선택한 다음 사용할 대기열을 입력합니다. ARN 메시지를 보낼 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다.

      자세한 내용은 DLQ(Dead Letter Queue)에 권한 부여 단원을 참조하십시오.

    API destination

    1. (선택 사항) 대상 입력 구성의 경우 일치하는 이벤트를 위해 대상으로 전송되는 텍스트를 사용자 지정하는 방법을 선택합니다. 다음 중 하나를 선택합니다.

      • 일치하는 이벤트 - 원본 소스 이벤트 전체를 대상으로 EventBridge 보냅니다. 이 값이 기본값입니다.

      • 일치하는 이벤트의 일부 - 원본 소스 이벤트의 지정된 EventBridge 부분만 대상으로 보냅니다.

        일치하는 이벤트의 부분 지정에서 대상으로 EventBridge 보내려는 이벤트 부분을 정의하는 JSON 경로를 지정합니다.

      • 상수 (JSON텍스트) - 지정된 JSON 텍스트만 대상으로 EventBridge 보냅니다. 원본 소스 이벤트의 어떤 부분도 전송되지 않습니다.

        상수 지정에서 JSON 이벤트 대신 대상에 EventBridge 보낼 JSON 텍스트를 지정합니다.

      • 입력 변환기 - 대상에 EventBridge 보낼 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 Amazon EventBridge 입력 변환 단원을 참조하십시오.

        1. 입력 변환기 구성을 선택합니다.

        2. 에서 규칙을 생성할 때 입력 변환기 구성 EventBridge의 단계에 따라 입력 변환기를 구성합니다.

    2. (선택 사항) 재시도 정책에서 오류 발생 후 타겟으로 이벤트 전송을 재시도하는 방법을 EventBridge 지정합니다.

      • 최대 이벤트 기간 - 처리되지 않은 이벤트를 보존할 최대 시간 (시간, 분, 초) EventBridge 을 입력합니다. 기본값은 24시간입니다.

      • 재시도 횟수 - 오류 발생 후 타겟으로 이벤트 전송을 EventBridge 재시도해야 하는 최대 횟수를 입력합니다. 기본값은 185회입니다.

    3. (선택 사항) 데드레터 대기열의 경우 표준 Amazon 대기열을 데드레터 SQS 대기열로 사용할지 여부를 선택합니다. EventBridge 타겟에 성공적으로 전송되지 않은 경우 이 규칙과 일치하는 이벤트를 데드레터 대기열로 전송합니다. 다음 중 하나를 수행합니다.

      • 배달 못한 편지 대기열을 사용하지 않으려면 없음(None)을 선택합니다.

      • 현재 AWS 계정에서 데드레터 SQS 대기열로 사용할 Amazon 대기열 선택을 선택한 다음 드롭다운 목록에서 사용할 대기열을 선택합니다.

      • 다른 AWS 계정의 Amazon SQS 대기열을 데드레터 대기열로 선택을 선택한 다음 사용할 대기열을 입력합니다. ARN 메시지를 보낼 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다.

        자세한 내용은 DLQ(Dead Letter Queue)에 권한 부여 단원을 참조하십시오.

    AWS service

    특정 AWS 서비스에 대한 다음 필드가 모두 표시되지 않을 EventBridge 수도 있습니다.

    1. (선택 사항) 대상 입력 구성의 경우 일치하는 이벤트를 위해 대상으로 전송되는 텍스트를 사용자 지정하는 방법을 선택합니다. 다음 중 하나를 선택합니다.

      • 일치하는 이벤트 - 원본 소스 이벤트 전체를 대상으로 EventBridge 보냅니다. 이 값이 기본값입니다.

      • 일치하는 이벤트의 일부 - 원본 소스 이벤트의 지정된 EventBridge 부분만 대상으로 보냅니다.

        일치하는 이벤트의 부분 지정에서 대상으로 EventBridge 보내려는 이벤트 부분을 정의하는 JSON 경로를 지정합니다.

      • 상수 (JSON텍스트) - 지정된 JSON 텍스트만 대상으로 EventBridge 보냅니다. 원본 소스 이벤트의 어떤 부분도 전송되지 않습니다.

        상수 지정에서 JSON 이벤트 대신 대상에 EventBridge 보낼 JSON 텍스트를 지정합니다.

      • 입력 변환기 - 대상에 EventBridge 보낼 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 Amazon EventBridge 입력 변환 단원을 참조하십시오.

        1. 입력 변환기 구성을 선택합니다.

        2. 에서 규칙을 생성할 때 입력 변환기 구성 EventBridge의 단계에 따라 입력 변환기를 구성합니다.

    2. (선택 사항) 재시도 정책에서 오류 발생 후 타겟으로 이벤트 전송을 재시도하는 방법을 EventBridge 지정합니다.

      • 최대 이벤트 기간 - 처리되지 않은 이벤트를 보존할 최대 시간 (시간, 분, 초) EventBridge 을 입력합니다. 기본값은 24시간입니다.

      • 재시도 횟수 - 오류 발생 후 타겟으로 이벤트 전송을 EventBridge 재시도해야 하는 최대 횟수를 입력합니다. 기본값은 185회입니다.

    3. (선택 사항) 데드레터 대기열의 경우 표준 Amazon 대기열을 데드레터 SQS 대기열로 사용할지 여부를 선택합니다. EventBridge 타겟에 성공적으로 전송되지 않은 경우 이 규칙과 일치하는 이벤트를 데드레터 대기열로 전송합니다. 다음 중 하나를 수행합니다.

      • 배달 못한 편지 대기열을 사용하지 않으려면 없음(None)을 선택합니다.

      • 현재 AWS 계정에서 데드레터 SQS 대기열로 사용할 Amazon 대기열 선택을 선택한 다음 드롭다운 목록에서 사용할 대기열을 선택합니다.

      • 다른 AWS 계정의 Amazon SQS 대기열을 데드레터 대기열로 선택을 선택한 다음 사용할 대기열을 입력합니다. ARN 메시지를 보낼 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다.

        자세한 내용은 DLQ(Dead Letter Queue)에 권한 부여 단원을 참조하십시오.

  4. (선택 사항) 이 규칙에 다른 대상을 추가하려면 다른 대상 추가를 선택합니다.

  5. Next(다음)를 선택합니다.

특정 AWS 서비스에 대한 다음 필드가 모두 표시되지 않을 EventBridge 수도 있습니다.

태그 구성 및 규칙 검토

마지막으로 규칙에 원하는 태그를 입력한 다음 규칙을 검토 및 생성합니다.

태그를 구성하고 규칙을 검토 및 생성하려면

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

  2. Next(다음)를 선택합니다.

  3. 새 규칙의 세부 정보를 검토합니다. 섹션을 변경하려면 해당 섹션 옆에 있는 편집 버튼을 선택합니다.

    규칙 세부 정보에 만족하면 규칙 생성을 선택합니다.