일정에 따라 실행되는 Amazon EventBridge 규칙 생성

규칙은 이벤트에 대한 응답으로 또는 특정 시간 간격으로 실행될 수 있습니다. 예를 들어 AWS Lambda 함수를 정기적으로 실행하려면 일정에 따라 실행되는 규칙을 생성하면 됩니다.

참고

EventBridge는 하나의 중앙 관리형 서비스에서 작업을 생성, 실행 및 관리할 수 있는 서버리스 스케줄러인 Amazon EventBridge 스케줄러를 제공합니다. EventBridge 스케줄러는 고도로 사용자 지정이 가능하며, 광범위한 대상 API 작업 및 AWS 서비스를 통해 EventBridge 예약 규칙보다 향상된 확장성을 제공합니다.

EventBridge Scheduler를 사용하여 일정에 따라 대상을 간접 호출하는 것이 좋습니다. 자세한 내용은 Amazon EventBridge와 함께 Amazon EventBridge 스케줄러 사용 섹션을 참조하세요.

EventBridge에서는 다음과 같은 2가지 유형의 예약된 규칙을 생성할 수 있습니다.

• 일정한 간격으로 실행되는 규칙

  EventBridge는 일정한 간격으로(예: 20분마다) 이러한 규칙을 실행합니다.

  예약된 규칙의 간격을 지정하려면 rate 표현식을 정의합니다.

• 특정 시간에 실행되는 규칙

  EventBridge는 특정 시간과 날짜에 이러한 규칙을 실행합니다(예: 매월 첫째 월요일 오전 8시 (PST)).

  예약된 규칙이 실행되는 시간과 날짜를 지정하려면 cron 표현식을 정의합니다.

rate 표현식은 정의하기가 더 간단하고 cron 표현식은 세부적인 일정 제어를 제공합니다. 예를 들어, cron 표현식을 사용하여 매주 또는 매월 특정 요일의 지정된 시간에 트리거되는 규칙을 정의할 수 있습니다. 반대로 rate 표현식은 매 시간 한 번 또는 매일 한 번과 같이 일정한 간격으로 규칙을 실행합니다.

예약된 모든 이벤트는 UTC+0 시간대를 사용하며 예약의 최소 단위는 1분입니다.

참고

EventBridge는 일정 표현식에 초 단위의 정밀성을 제공하지 않습니다. cron 표현식을 사용해 가장 정밀하게 설정할 수 있는 단위가 1분입니다. EventBridge와 대상 서비스가 분산되어 있기 때문에 예약된 규칙이 트리거되는 시간과 대상 서비스가 대상 리소스 실행하는 시간 사이에 몇 초의 지연이 있을 수 있습니다.

다음 비디오는 작업 예약에 대한 개요를 제공합니다.

주제

• 일정에 따라 실행되는 규칙 생성
• cron 표현식 참조
• rate 표현식 참조

일정에 따라 실행되는 규칙 생성

다음 단계는 정기적인 일정에 따라 실행되는 EventBridge 규칙을 만드는 방법을 안내합니다.

참고

기본 이벤트 버스를 사용해야만 예약된 규칙을 생성할 수 있습니다.

규칙 정의

먼저 규칙을 식별할 수 있도록 규칙의 이름과 설명을 입력합니다.

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

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

2. 탐색 창에서 [Rules]를 선택합니다.

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

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

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

5. 이벤트 버스에서 기본 이벤트 버스를 선택합니다. 기본 이벤트 버스를 사용해야만 예약된 규칙을 생성할 수 있습니다.

6. 규칙을 생성하는 즉시 적용되도록 하려면 선택한 이벤트 버스에 대해 규칙 활성화 옵션이 활성화되어 있어야 합니다.

7. 규칙 유형에서 스케줄을 선택합니다.

   이제 일정에 따라 실행되는 규칙을 계속 생성하거나 Amazon EventBridge 스케줄러를 사용할 수 있습니다.

8. 계속할 방법을 선택합니다.

   • EventBridge Scheduler를 사용하여 일정 생성

     참고

     EventBridge Scheduler는 하나의 중앙 관리형 서비스에서 작업을 생성, 실행 및 관리할 수 있는 서버리스 스케줄러입니다. 이벤트 버스 및 규칙과 관계없이 일회성 및 반복 예약 기능을 제공합니다. EventBridge 스케줄러는 고도로 사용자 지정이 가능하며, 광범위한 대상 API 작업 및 AWS 서비스를 통해 EventBridge 예약 규칙보다 향상된 확장성을 제공합니다.

     EventBridge Scheduler를 사용하여 일정에 따라 대상을 간접 호출하는 것이 좋습니다. 자세한 내용은 Amazon EventBridge 스케줄러 사용자 가이드의 Amazon EventBridge 스케줄러란?을 참조합니다.

     1. EventBridge Scheduler에서 계속을 선택합니다.

        EventBridge는 EventBridge Scheduler 콘솔에서 일정 생성 페이지를 엽니다.

     2. EventBridge Scheduler 콘솔에서 일정을 생성합니다.

   • EventBridge를 계속 사용하여 기본 이벤트 버스에 대한 예약 규칙 생성

     1. 규칙 생성으로 이동을 선택합니다.

일정 정의

다음으로 일정 패턴을 정의합니다.

일정 패턴을 정의하려면

1. 일정 패턴에서 일정을 특정 시간에 실행할지 아니면 일정한 간격으로 실행할지를 선택합니다.

   Specific time

   1. 특정 시간(예: 매월 첫 번째 월요일 오전 8시 PST)에 실행되는 세분화된 일정을 선택합니다.

   2. Cron 표현식의 경우 EventBridge가 이 예약된 규칙을 실행할 시기를 결정하는 데 사용해야 하는 cron 표현식을 정의하는 필드를 지정합니다.

      모든 필드를 지정하고 나면 EventBridge는 EventBridge가 이 예약된 규칙을 실행할 다음 10개 날짜를 표시합니다. 해당 날짜를 UTC 또는 현지 시간대로 표시할지 선택할 수 있습니다.

      cron 표현식 구성에 대한 자세한 내용은 cron 표현식 참조 섹션을 참조하세요.

   Regular rate

   1. 일정한 간격(예: 10분마다)으로 실행되는 일정을 선택합니다.

   2. rate 표현식의 경우 값 및 단위 필드를 지정하여 EventBridge가 이 예약된 규칙을 실행해야 하는 간격을 정의합니다.

      rate 표현식 구성에 대한 자세한 내용은 rate 표현식 참조 섹션을 참조하세요.

2. 다음을 선택합니다.

대상 선택

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

대상을 선택하려면

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

   Event bus

   EventBridge 이벤트 버스를 선택하려면 EventBridge 이벤트 버스를 선택하고 다음을 수행합니다.

   • 이 규칙과 동일하게 AWS 리전에서 이벤트 버스를 사용하려면:

     1. 동일한 계정 및 리전의 이벤트 버스를 선택합니다.

     2. 대상에 대한 이벤트 버스의 경우 드롭다운 상자를 선택하고 이벤트 버스의 이름을 입력합니다. 드롭다운 목록에서 이벤트 버스를 선택할 수도 있습니다.

        자세한 내용은 동일한 계정 및 지역의 이벤트 버스 간에 Amazon EventBridge 이벤트 전송 및 수신 섹션을 참조하세요.

   • 다음 규칙에 따라 다른 AWS 리전 또는 계정의 이벤트 버스를 사용하려면:

     1. 다른 계정 또는 리전의 이벤트 버스를 선택합니다.

     2. 대상 이벤트 버스에는 사용하려는 이벤트 버스의 ARN을 입력합니다.

        자세한 내용은 다음을 참조하세요.

        • AWS 계정 간 Amazon EventBridge 이벤트 전송 및 수신

        • AWS 지역 간 Amazon 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는 이 규칙과 일치하는 이벤트를 DLQ(Dead Letter Queue)로 보냅니다. 다음 중 하나를 수행합니다.

   • 배달 못한 편지 대기열을 사용하지 않으려면 없음(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에서 처리되지 않은 이벤트를 유지할 수 있는 최대 시간(시간, 분, 초)을 입력합니다. 기본값은 24시간입니다.

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

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

      • 배달 못한 편지 대기열을 사용하지 않으려면 없음(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에서 처리되지 않은 이벤트를 유지할 수 있는 최대 시간(시간, 분, 초)을 입력합니다. 기본값은 24시간입니다.

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

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

      • 배달 못한 편지 대기열을 사용하지 않으려면 없음(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. 다음을 선택합니다.

태그 구성 및 규칙 검토

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

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

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

2. 다음을 선택합니다.

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

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