이벤트에 반응하는 Amazon EventBridge 규칙 생성 - 아마존 EventBridge

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

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

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

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

이벤트에 반응하는 규칙 만들기

다음 단계는 이벤트가 지정된 이벤트 버스로 전송될 때 EventBridge에서 이벤트를 일치시키는 데 사용하는 규칙을 만드는 방법을 안내합니다.

규칙 정의

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

규칙 세부 정보를 정의하려면
  1. https://console.aws.amazon.com/events/에서 Amazon EventBridge 콘솔을 엽니다.

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

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

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

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

  5. 이벤트 버스에서 이 규칙과 연결할 이벤트 버스를 선택합니다. 이 규칙이 자신의 계정에서 발생하는 이벤트와 일치하도록 하려면 AWS 기본 이벤트 버스를 선택합니다. 사용자 계정의 AWS 서비스가 이벤트를 내보내면 그 이벤트는 계정의 기본 이벤트 버스로 이동합니다.

  6. 규칙 유형에서 이벤트 패턴이 있는 규칙을 선택합니다.

  7. 다음을 선택합니다.

이벤트 패턴 작성

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

이벤트 패턴을 작성하려면
  1. 이벤트 소스에서 AWS 이벤트 또는 EventBridge 파트너 이벤트를 선택합니다.

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

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

    • AWS 이벤트 - 지원되는 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는 샘플 이벤트가 이벤트 패턴과 일치하는지 여부를 나타내는 메시지 상자를 표시합니다.

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

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

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

    Custom schema

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

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

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

    3. 텍스트 상자에 스키마를 입력합니다. 스키마의 형식을 유효한 JSON 텍스트로 지정해야 합니다.

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

      참고

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

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

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

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

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

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

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

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

    Event pattern

    JSON 형식의 사용자 지정 이벤트 패턴을 작성하려면 다음을 수행하세요.

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

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

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

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

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

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

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

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

  4. 다음을 선택합니다.

대상 선택

지정된 패턴과 일치하는 이벤트를 수신할 대상을 하나 이상 선택합니다. 대상은 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으로 설정됩니다.

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

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

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

    자세한 내용은 API 대상 섹션을 참조하세요.

    AWS 서비스

    AWS 서비스를 사용하려면 AWS 서비스를 선택하고 다음을 수행합니다.

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

      참고

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

  2. 여러 대상 유형에 대해 EventBridge에서는 대상에 이벤트를 보낼 권한이 필요합니다. 이 경우 EventBridge는 규칙 실행에 필요한 IAM 역할을 생성할 수 있습니다.

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

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

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

      2. 이 실행 역할의 이름을 입력하거나 EventBridge에서 생성된 이름을 사용합니다.

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

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

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

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

    Event bus

    (선택 사항) DLQ(Dead Letter Queue)에서 표준 Amazon SQS 대기열을 배달 못한 편지 대기열로 사용할지를 선택합니다. 이벤트가 대상에 성공적으로 전달되지 않은 경우 EventBridge는 이 규칙과 일치하는 이벤트를 배달 못한 편지 대기열로 보냅니다. 다음 중 하나를 수행합니다.

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

    • 현재 AWS 계정에서 배달 못한 편지 대기열로 사용할 대기열 선택(Select an Amazon SQS queue in the current account to use as the dead-letter queue)을 선택하고 드롭다운 목록에서 사용할 대기열을 선택합니다.

    • 다른 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열 선택(Select an Amazon SQS queue in an other account as a dead-letter queue)을 선택하고 사용할 대기열의 ARN을 입력합니다. 메시지를 보낼 수 있는 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다.

      자세한 내용은 DLQ(Dead Letter Queue)에 권한 부여 섹션을 참조하세요.

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

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

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

        일치하는 이벤트의 일부를 지정합니다.에서 EventBridge가 대상으로 전송할 이벤트 부분을 정의하는 JSON 경로를 지정합니다.

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

        JSON으로 상수를 지정에서 EventBridge가 이벤트 대신 대상으로 전송할 JSON 텍스트를 지정합니다.

      • 입력 변환기 - EventBridge가 대상으로 보낼 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 아마존 EventBridge 인풋 트랜스포메이션 섹션을 참조하세요.

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

        2. 규칙 생성 과정으로 입력 변환기 구성의 단계에 따라 입력 변환기를 구성합니다.

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

      • 최대 이벤트 기간 - EventBridge에서 처리되지 않은 이벤트를 유지할 수 있는 최대 시간(시간, 분, 초)을 입력합니다. 기본값은 18시간입니다.

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

    3. (선택 사항) DLQ(Dead Letter Queue)에서 표준 Amazon SQS 대기열을 배달 못한 편지 대기열로 사용할지를 선택합니다. 이벤트가 대상에 성공적으로 전달되지 않은 경우 EventBridge는 이 규칙과 일치하는 이벤트를 배달 못한 편지 대기열로 보냅니다. 다음 중 하나를 수행합니다.

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

      • 현재 AWS 계정에서 배달 못한 편지 대기열로 사용할 대기열 선택(Select an Amazon SQS queue in the current account to use as the dead-letter queue)을 선택하고 드롭다운 목록에서 사용할 대기열을 선택합니다.

      • 다른 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열 선택(Select an Amazon SQS queue in an other account as a dead-letter queue)을 선택하고 사용할 대기열의 ARN을 입력합니다. 메시지를 보낼 수 있는 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다.

        자세한 내용은 DLQ(Dead Letter Queue)에 권한 부여 섹션을 참조하세요.

    AWS service

    EventBridge는 특정 AWS 서비스에 대해 다음 필드를 모두 표시하지 않을 수 있다는 점에 유의합니다.

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

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

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

        일치하는 이벤트의 일부를 지정합니다.에서 EventBridge가 대상으로 전송할 이벤트 부분을 정의하는 JSON 경로를 지정합니다.

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

        JSON으로 상수를 지정에서 EventBridge가 이벤트 대신 대상으로 전송할 JSON 텍스트를 지정합니다.

      • 입력 변환기 - EventBridge가 대상으로 보낼 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 아마존 EventBridge 인풋 트랜스포메이션 섹션을 참조하세요.

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

        2. 규칙 생성 과정으로 입력 변환기 구성의 단계에 따라 입력 변환기를 구성합니다.

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

      • 최대 이벤트 기간 - EventBridge에서 처리되지 않은 이벤트를 유지할 수 있는 최대 시간(시간, 분, 초)을 입력합니다. 기본값은 18시간입니다.

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

    3. (선택 사항) DLQ(Dead Letter Queue)에서 표준 Amazon SQS 대기열을 배달 못한 편지 대기열로 사용할지를 선택합니다. 이벤트가 대상에 성공적으로 전달되지 않은 경우 EventBridge는 이 규칙과 일치하는 이벤트를 배달 못한 편지 대기열로 보냅니다. 다음 중 하나를 수행합니다.

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

      • 현재 AWS 계정에서 배달 못한 편지 대기열로 사용할 대기열 선택(Select an Amazon SQS queue in the current account to use as the dead-letter queue)을 선택하고 드롭다운 목록에서 사용할 대기열을 선택합니다.

      • 다른 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열 선택(Select an Amazon SQS queue in an other account as a dead-letter queue)을 선택하고 사용할 대기열의 ARN을 입력합니다. 메시지를 보낼 수 있는 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다.

        자세한 내용은 DLQ(Dead Letter Queue)에 권한 부여 섹션을 참조하세요.

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

  5. 다음을 선택합니다.

EventBridge는 특정 AWS 서비스에 대해 다음 필드를 모두 표시하지 않을 수 있다는 점에 유의합니다.

태그 구성 및 규칙 검토

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

태그를 구성하고 규칙을 검토 및 생성하려면
  1. (선택 사항) 규칙에 대해 하나 이상의 태그를 입력하세요. 자세한 내용은 아마존 EventBridge 태그 섹션을 참조하세요.

  2. 다음을 선택합니다.

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

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