기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon EventBridge Scheduler [Amazon EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)는 하나의 중앙 관리형 서비스에서 작업을 생성, 실행 및 관리할 수 있는 서버리스 스케줄러입니다. EventBridge 스케줄러를 사용하면 반복 패턴에 대해 cron 및 rate 표현식을 사용하여 일정을 만들거나 일회성 간접 호출을 구성할 수 있습니다. 전송을 위한 유연한 기간을 설정하고, 재시도 제한을 정의하고, 실패한 API 간접 호출의 최대 보존 시간을 설정할 수 있습니다. ![\[일정은 특정 시간 또는 정의된 간격으로 지정된 AWS 서비스 API로 작업을 전송합니다.\]](http://docs.aws.amazon.com/ko_kr/eventbridge/latest/userguide/images/schedule-types_eventbridge_conceptual.svg) EventBridge 스케줄러는 사용자 지정이 가능하며 더 광범위한 대상 API 작업 및 AWS 서비스를 통해 [EventBridge 예약 규칙](eb-create-rule-schedule.md)보다 향상된 확장성을 제공합니다. EventBridge Scheduler를 사용하여 일정에 따라 대상을 간접 호출하는 것이 좋습니다. ## 실행 역할 설정 새 일정을 생성할 때 EventBridge 스케줄러에 사용자를 대신하여 대상 API 작업을 간접적으로 간접 호출할 수 있는 권한이 있어야 합니다. *실행 역할*을 사용하여 EventBridge 스케줄러에 이러한 권한을 부여합니다. 일정의 실행 역할에 연결하는 권한 정책은 필요한 권한을 정의합니다. 이러한 권한은 EventBridge 스케줄러가 간접적으로 간접 호출하려는 대상 API에 따라 달라집니다. 다음 절차와 같이 EventBridge 스케줄러 콘솔을 사용하여 일정을 생성하면 EventBridge 스케줄러가 선택한 대상을 기준으로 실행 역할을 자동으로 설정합니다. EventBridge 스케줄러 SDKs, AWS CLI또는 중 하나를 사용하여 일정을 생성하려면 EventBridge 스케줄러가 대상을 호출하는 데 필요한 권한을 부여하는 기존 실행 역할이 있어야 CloudFormation합니다. 일정에 대한 실행 역할을 수동으로 설정하는 방법에 대한 자세한 내용은 **EventBridge 스케줄러 사용 설명서의 [Setting up an execution role](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role)을 참조하세요. ## 관련 리소스 EventBridge 스케줄러에 대한 자세한 내용은 다음을 참조하세요. + [EventBridge 스케줄러 사용 설명서](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html) + [EventBridge 스케줄러 API 참조](https://docs.aws.amazon.com/scheduler/latest/APIReference/Welcome.html) + [EventBridge 스케줄러 요금](https://aws.amazon.com/eventbridge/pricing/#Scheduler) ## 일정 생성 **콘솔을 사용하여 일정 생성** 1. [https://console.aws.amazon.com/scheduler/home](https://console.aws.amazon.com/scheduler/home/)에서 Amazon EventBridge Scheduler 콘솔을 엽니다. 1. **일정** 페이지에서 **일정 생성**을 선택합니다. 1. **일정 세부 정보 지정** 페이지의 **일정 이름 및 설명** 섹션에서 다음을 수행합니다. 1. **일정 이름**에 일정의 이름을 입력합니다. 예를 들어 **MyTestSchedule**입니다. 1. (선택 사항) **설명**에 일정에 대한 설명을 입력합니다. 예를 들어 **My first schedule**입니다. 1. **일정 그룹** 드롭다운 목록에서 일정 그룹을 선택합니다. 그룹이 없는 경우 **기본값**을 선택합니다. 일정 그룹을 생성하려면 **자체 일정 생성**을 선택합니다. 일정 그룹을 사용하여 일정 그룹에 태그를 추가합니다. 1. 1. 일정 옵션을 선택합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/eventbridge/latest/userguide/using-eventbridge-scheduler.html) 1. (선택 사항) 이전 단계에서 **반복 일정**을 선택한 경우 **기간** 섹션에서 다음을 수행합니다. 1. **시간대**에서 시간대를 선택합니다. 1. **시작 날짜 및 시간**에 `YYYY/MM/DD` 형식으로 유효한 날짜를 입력한 다음 24시간 `hh:mm` 형식으로 타임스탬프를 지정합니다. 1. **종료 날짜 및 시간**에 `YYYY/MM/DD` 형식으로 유효한 날짜를 입력한 다음 24시간 `hh:mm` 형식으로 타임스탬프를 지정합니다. 1. **다음**을 선택합니다. 1. **대상 선택** 페이지에서 EventBridge 스케줄러가 호출하는 AWS API 작업을 선택합니다. 1. **대상 API**의 경우 **템플릿 형식의 대상**을 선택합니다. 1. **Amazon EventBridge PutEvents**를 선택합니다. 1. **PutEvents**에서 다음을 지정합니다. + **EventBridge 이벤트 버스**의 경우 드롭다운 메뉴에서 이벤트 버스를 선택합니다. 예를 들어 **default**입니다. EventBridge 콘솔에서 **새 이벤트 버스 생성**을 선택하여 새 이벤트 버스를 생성할 수도 있습니다. + **세부 유형**에는 매칭하려는 이벤트의 세부 유형을 입력합니다. 예를 들어 **Object Created**입니다. + **소스**에는 이벤트의 소스인 서비스 이름을 입력합니다. AWS 서비스 이벤트의 경우 서비스 접두사를 소스로 지정합니다. `aws.` 접두사는 포함하지 마세요. 예를 들어, Amazon S3 이벤트의 경우 **s3**을 입력합니다. 서비스의 접두사를 확인하려면 서비스 권한 부여 참조의 [조건 키 테이블](https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html#context_keys_table)을 참조하세요.** 소스 및 세부 정보 유형 이벤트 값에 대한 자세한 내용은 [이벤트 참조](https://docs.aws.amazon.com/eventbridge/latest/ref/events-structure.html)의 *AWS 서비스 이벤트 메타데이터*를 참조하세요.>. + (선택 사항): **세부 정보**에 이벤트 패턴을 입력하여 EventBridge 스케줄러가 EventBridge로 보내는 이벤트를 추가로 필터링합니다. 자세한 내용은 [Amazon EventBridge 이벤트 패턴 생성](eb-event-patterns.md) 단원을 참조하십시오. 1. **다음**을 선택합니다. 1. **설정** 페이지에서 다음 작업을 수행합니다. 1. 일정을 켜려면 **일정 상태**에서 **일정 활성화**를 토글합니다. 1. 일정에 대한 재시도 정책을 구성하려면 **재시도 정책 및 데드-레터 큐(DLQ)**에서 다음을 수행합니다. + **재시도**를 토글합니다. + **최대 이벤트 수명**에 EventBridge 스케줄러가 처리되지 않은 이벤트를 보관해야 하는 최대 **시간**과 **분**을 입력합니다. + 최대 시간은 24시간입니다. + **최대 재시도 횟수**에는 대상이 오류를 반환할 경우 EventBridge 스케줄러가 일정을 재시도하는 최대 횟수를 입력합니다. 최댓값은 185회입니다. 재시도 정책을 사용하면 일정이 대상을 간접적으로 간접 호출하지 못할 경우 EventBridge 스케줄러가 일정을 다시 실행합니다. 구성된 경우 일정에 대한 최대 보존 기간과 재시도 횟수를 설정해야 합니다. 1. EventBridge 스케줄러가 전송되지 않은 이벤트를 저장하는 위치를 선택합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/eventbridge/latest/userguide/using-eventbridge-scheduler.html) 1. 고객 관리형 키를 사용하여 대상 입력을 암호화하려면 **암호화**에서 **암호화 설정 사용자 지정(고급)**을 선택합니다. 이 옵션을 선택하는 경우 기존 KMS 키 ARN을 입력하거나 ** AWS KMS key생성**을 선택하여 AWS KMS 콘솔로 이동합니다. EventBridge 스케줄러가 저장 데이터를 암호화하는 방법에 대한 자세한 내용은 *Amazon EventBridge 스케줄러 사용 설명서*의 [Encryption at rest](https://docs.aws.amazon.com/scheduler/latest/UserGuide/encryption-rest.html)를 참조하세요. 1. EventBridge 스케줄러가 새 실행 역할을 생성하도록 하려면 **이 일정에 대한 새 역할 생성**을 선택합니다. 그런 다음 **역할 이름**을 입력합니다. 이 옵션을 선택하면 EventBridge 스케줄러가 템플릿 대상에 필요한 필수 권한을 역할에 연결합니다. 1. **다음**을 선택합니다. 1. **일정 검토 및 생성** 페이지에서 일정의 세부 정보를 검토합니다. 각 섹션에서 **편집**을 선택하여 해당 단계로 돌아가서 세부 정보를 편집합니다. 1. **일정 생성**을 선택합니다. **일정** 페이지에서 새 일정과 기존 일정 목록을 볼 수 있습니다. **상태** 열에서 새 일정이 **활성화됨** 상태인지 확인합니다. # Amazon EventBridge에서 예약된 규칙(레거시) 생성 **참고** 예약된 규칙은 EventBridge의 레거시 기능입니다. EventBridge는 대규모로 예약된 작업을 중앙에서 생성, 실행 및 관리하는 보다 유연하고 강력한 방법인 EventBridge 스케줄러를 제공합니다. EventBridge 스케줄러를 사용하면 반복 패턴에 대해 cron 및 rate 표현식을 사용하여 일정을 만들거나 일회성 간접 호출을 구성할 수 있습니다. 전송을 위한 유연한 기간을 설정하고, 재시도 제한을 정의하고, 실패한 API 간접 호출의 최대 보존 시간을 설정할 수 있습니다. 스케줄러는 사용자 지정이 가능하며 더 광범위한 대상 API 작업 및 AWS 서비스를 통해 예약된 규칙보다 향상된 확장성을 제공합니다. 스케줄러를 사용하여 일정에 따라 대상을 간접적으로 호출하는 것이 좋습니다. 자세한 내용은 [일정 생성](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) 또는 *[EventBridge 스케줄러 사용 설명서를](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)* 참조하세요. EventBridge에서는 다음과 같은 2가지 유형의 예약된 규칙을 생성할 수 있습니다. + 일정한 간격으로 실행되는 규칙 EventBridge는 일정한 간격으로(예: 20분마다) 이러한 규칙을 실행합니다. 예약된 규칙의 간격을 지정하려면 *rate 표현식*을 정의합니다. + 특정 시간에 실행되는 규칙 EventBridge는 특정 시간과 날짜에 이러한 규칙을 실행합니다(예: 매월 첫째 월요일 오전 8시 (PST)). 예약된 규칙이 실행되는 시간과 날짜를 지정하려면 *cron 표현식*을 정의합니다. rate 표현식은 정의하기가 더 간단하고 cron 표현식은 세부적인 일정 제어를 제공합니다. 예를 들어, cron 표현식을 사용하여 매주 또는 매월 특정 요일의 지정된 시간에 트리거되는 규칙을 정의할 수 있습니다. 반대로 rate 표현식은 매 시간 한 번 또는 매일 한 번과 같이 일정한 간격으로 규칙을 실행합니다. 예약된 모든 이벤트는 UTC\$10 시간대를 사용하며 예약의 최소 단위는 1분입니다. **참고** EventBridge는 일정 표현식에 초 단위의 정밀성을 제공하지 않습니다. cron 표현식을 사용해 가장 정밀하게 설정할 수 있는 단위가 1분입니다. EventBridge와 대상 서비스가 분산되어 있기 때문에 예약된 규칙이 트리거되는 시간과 대상 서비스가 대상 리소스 실행하는 시간 사이에 몇 초의 지연이 있을 수 있습니다. ## 예약된 규칙 생성(레거시) 다음 단계는 정기적인 일정에 따라 실행되는 EventBridge 규칙을 만드는 방법을 안내합니다. **참고** 기본 이벤트 버스를 사용해야만 예약된 규칙을 생성할 수 있습니다. **Topics** + [ ### 규칙 정의 ](#eb-create-scheduled-rule-define) + [ ### 일정 정의 ](#eb-create-scheduled-rule-schedule) + [ ### 대상 선택 ](#eb-create-scheduled-rule-target) + [ ### 태그 구성 및 규칙 검토 ](#eb-create-scheduled-rule-review) ### 규칙 정의 먼저 규칙을 식별할 수 있도록 규칙의 이름과 설명을 입력합니다. **규칙 세부 정보를 정의하려면** 1. Amazon EventBridge 콘솔([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/))을 엽니다. 1. 탐색 창의 **스케줄러**에서 **예약된 규칙(레거시)**을 선택합니다. 1. **예약된 규칙 생성을** 선택합니다. 1. 규칙의 **이름**을 입력하고 선택적으로 **설명**을 입력합니다. 규칙은 동일한 및 동일한 이벤트 버스의 다른 규칙 AWS 리전 과 동일한 이름을 가질 수 없습니다. 1. 규칙을 생성하는 즉시 규칙을 적용하려면 **예약된 규칙 활성화** 옵션이 활성화되어 있는지 확인합니다. ### 일정 정의 다음으로 일정 패턴을 정의합니다. **일정 패턴을 정의하려면** + **일정 패턴**에서 일정을 특정 시간에 실행할지 아니면 일정한 간격으로 실행할지를 선택합니다. ------ #### [ Specific time ] 1. **특정 시간(예: 매월 첫 번째 월요일 오전 8시 PST)에 실행되는 세분화된 일정**을 선택합니다. 1. **Cron 표현식**의 경우 EventBridge가 이 예약된 규칙을 실행할 시기를 결정하는 데 사용해야 하는 cron 표현식을 정의하는 필드를 지정합니다. 모든 필드를 지정하고 나면 EventBridge는 EventBridge가 이 예약된 규칙을 실행할 다음 10개 날짜를 표시합니다. 해당 날짜를 **UTC** 또는 **현지 시간대**로 표시할지 선택할 수 있습니다. cron 표현식 구성에 대한 자세한 내용은 [cron 표현식](eb-scheduled-rule-pattern.md#eb-cron-expressions) 섹션을 참조하세요. ------ #### [ Regular rate ] 1. **일정한 간격(예: 10분마다)으로 실행되는 일정**을 선택합니다. 1. **rate 표현식**의 경우 **값** 및 **단위** 필드를 지정하여 EventBridge가 이 예약된 규칙을 실행해야 하는 간격을 정의합니다. rate 표현식 구성에 대한 자세한 내용은 [rate 표현식](eb-scheduled-rule-pattern.md#eb-rate-expressions) 섹션을 참조하세요. ------ ### 대상 선택 지정된 패턴과 일치하는 이벤트를 수신할 대상을 하나 이상 선택합니다. 대상은 EventBridge 이벤트 버스, Salesforce 등의 SaaS 파트너를 포함한 EventBridge API 대상 또는 다른 AWS 서비스를 포함할 수 있습니다. **대상을 선택하려면** 1. **대상 유형**에서 다음 대상 유형 중 하나를 선택합니다. ------ #### [ Event bus ] EventBridge 이벤트 버스를 선택하려면 **EventBridge 이벤트 버스**를 선택하고 다음을 수행합니다. + AWS 리전 이 규칙과 동일한에서 이벤트 버스를 사용하려면: 1. **동일한 계정 및 리전의 이벤트 버스**를 선택합니다. 1. **대상에 대한 이벤트 버스**의 경우 드롭다운 상자를 선택하고 이벤트 버스의 이름을 입력합니다. 드롭다운 목록에서 이벤트 버스를 선택할 수도 있습니다. 자세한 내용은 [Amazon EventBridge에서 동일한 계정 및 리전의 이벤트 버스 간 이벤트 전송](eb-bus-to-bus.md) 단원을 참조하십시오. + 다른 AWS 리전 또는 계정의 이벤트 버스를이 규칙으로 사용하려면: 1. **다른 계정 또는 리전의 이벤트 버스**를 선택합니다. 1. **대상 이벤트 버스**에는 사용하려는 이벤트 버스의 ARN을 입력합니다. 자세한 내용은 다음을 참조하세요. + [Amazon EventBridge의 AWS 계정 간에 이벤트 전송 및 수신](eb-cross-account.md) + [Amazon EventBridge의 AWS 리전 간에 이벤트 전송 및 수신](eb-cross-region.md) ------ #### [ API destination ] EventBridge API 대상을 사용하려면 **EventBridge API 대상**을 선택한 후 다음 중 하나를 수행합니다. + 기존 API 대상을 사용하려면 **기존 API 대상 사용**을 선택합니다. 그런 다음 드롭다운 목록에서 API 대상을 선택합니다. + 새 API 대상을 생성하려면 **새 API 대상 생성**을 선택합니다. 그런 다음 대상에 대해 다음 세부 정보를 제공합니다. + **이름** - 대상의 이름을 입력합니다. 이름은 AWS 계정내에서 고유해야 합니다. 이름은 최대 64자까지 가능합니다. 유효한 문자는 **A\$1Z**, **a-z**, **0-9** 및 **.** **\$1** **-**(하이픈)입니다. + (선택 사항) **설명** – 대상에 대한 설명을 입력합니다. 설명은 최대 512자까지 가능합니다. + **API 대상 엔드포인트** — 대상의 URL 엔드포인트입니다. 엔드포인트 URL은 **https**로 시작해야 합니다. **\$1**를 경로 파라미터 와일드카드로 포함할 수 있습니다. 대상 `HttpParameters` 속성에서 경로 파라미터를 설정할 수 있습니다. + **HTTP 메서드** - 엔드포인트를 간접 호출할 때 사용할 HTTP 메서드를 선택합니다. + (선택 사항) **초당 간접 호출 속도 제한** — 이 대상에 대해 초당 허용되는 최대 간접 호출 수를 입력합니다. 이 값은 0보다 커야 합니다. 기본적으로 이 값은 300으로 설정됩니다. + **연결** — 새 연결을 사용할지 기존 연결을 사용할지 선택합니다. + 기존 연결을 사용하려면 **기존 연결 사용**을 선택하고 드롭다운 목록에서 연결을 선택합니다. + 이 대상에 대한 새 연결을 만들려면 **새 연결 만들기**를 선택한 다음 연결의 **이름**, **대상 유형** 및 **권한 부여** 유형을 정의합니다. 이 연결에 대한 **설명**(선택 사항)을 추가할 수도 있습니다. 자세한 내용은 [Amazon EventBridge의 대상으로 사용되는 API 데스티네이션](eb-api-destinations.md) 단원을 참조하십시오. ------ #### [ AWS 서비스 ] 를 사용하려면를 AWS 서비스선택한 후 다음을 **AWS 서비스**수행합니다. 1. **대상 선택**에서 대상으로 사용할 AWS 서비스 를 선택합니다. 선택한 서비스에 대해 요청된 정보를 제공합니다. **참고** 표시되는 필드는 선택한 서비스에 따라 달라집니다. 사용 가능한 대상에 대한 자세한 내용은 [EventBridge 콘솔에서 사용 가능한 이벤트 버스 대상](eb-targets.md#eb-console-targets) 섹션을 참조하세요. ------ 1. 여러 대상 유형에 대해 EventBridge에서는 대상에 이벤트를 보낼 권한이 필요합니다. 이 경우 EventBridge는 규칙 실행에 필요한 IAM 역할을 생성할 수 있습니다. **실행 역할**에서는 다음 중 하나를 수행합니다. + 이 규칙의 새 실행 역할을 만들려면: 1. **이 특정 리소스에 대해 새 역할 생성**을 선택합니다. 1. 이 실행 역할의 이름을 입력하거나 EventBridge에서 생성된 이름을 사용합니다. + 이 규칙에 기존 실행 역할을 사용하려면: 1. **기존 역할 사용**을 선택합니다. 1. 드롭다운 목록에서 사용할 실행 역할의 이름을 입력하거나 선택합니다. 1. (선택 사항) **추가 설정**의 경우 대상 유형에 사용할 수 있는 선택적 설정을 지정합니다. ------ #### [ Event bus ] (선택 사항) **DLQ(Dead Letter Queue)**에서 표준 Amazon SQS 대기열을 배달 못한 편지 대기열로 사용할지를 선택합니다. 이벤트가 대상에 성공적으로 전달되지 않은 경우 EventBridge는 이 규칙과 일치하는 이벤트를 DLQ(Dead Letter Queue)로 보냅니다. 다음 중 하나를 수행합니다. + 배달 못한 편지 대기열을 사용하지 않으려면 **없음(None)**을 선택합니다. + **현재 AWS 계정에서 배달 못한 편지 대기열로 사용할 대기열 선택(Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue)**을 선택한 다음, 드롭다운 목록에서 사용할 대기열을 선택합니다. + **다른 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열 선택(Select an Amazon SQS queue in an other AWS account as a dead-letter queue)**을 선택한 다음, 사용할 대기열의 ARN을 입력합니다. 메시지를 보낼 수 있는 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다. 자세한 내용은 [DLQ(Dead Letter Queue)에 권한 부여](eb-rule-dlq.md#eb-dlq-perms) 단원을 참조하십시오. ------ #### [ API destination ] 1. (선택 사항) 대상 입력 구성의 경우 일치하는 이벤트를 위해 대상으로 전송되는 텍스트를 사용자 지정하는 방법을 선택합니다. 다음 중 하나를 선택합니다. + **일치하는 이벤트** — EventBridge는 원본 소스 이벤트 전체를 대상으로 보냅니다. 기본값입니다. + **일치하는 이벤트의 일부** — EventBridge는 원본 소스 이벤트의 지정된 부분만 대상에 보냅니다. **일치하는 이벤트의 일부를 지정합니다.**에서 EventBridge가 대상으로 전송할 이벤트 부분을 정의하는 JSON 경로를 지정합니다. + **상수(JSON 텍스트)** - EventBridge는 지정된 JSON 텍스트만 대상으로 전송합니다. 원본 소스 이벤트의 어떤 부분도 전송되지 않습니다. **JSON으로 상수를 지정**에서 EventBridge가 이벤트 대신 대상으로 전송할 JSON 텍스트를 지정합니다. + **입력 변환기** - EventBridge가 대상으로 보낼 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 [Amazon EventBridge 입력 변환](eb-transform-target-input.md) 단원을 참조하십시오. 1. **입력 변환기 구성**을 선택합니다. 1. [EventBridge에서 규칙을 생성할 때 입력 변환기 구성](eb-transform-input-rule.md)의 단계에 따라 입력 변환기를 구성합니다. 1. (선택 사항) **재시도 정책**에서 오류 발생 후 EventBridge가 대상으로의 이벤트 전송을 재시도하는 방법을 지정합니다. + **최대 이벤트 기간** - EventBridge에서 처리되지 않은 이벤트를 유지할 수 있는 최대 시간(시간, 분, 초)을 입력합니다. 기본값은 24시간입니다. + **재시도** - 오류 발생 후 EventBridge가 대상으로 이벤트 전송을 재시도해야 하는 최대 횟수를 입력합니다. 기본값은 185회입니다. 1. (선택 사항) **DLQ(Dead Letter Queue)**에서 표준 Amazon SQS 대기열을 배달 못한 편지 대기열로 사용할지를 선택합니다. 이벤트가 대상에 성공적으로 전달되지 않은 경우 EventBridge는 이 규칙과 일치하는 이벤트를 DLQ(Dead Letter Queue)로 보냅니다. 다음 중 하나를 수행합니다. + 배달 못한 편지 대기열을 사용하지 않으려면 **없음(None)**을 선택합니다. + **현재 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열** 선택을 선택한 다음 드롭다운 목록에서 사용할 대기열을 선택합니다. + **다른 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열 선택**을 선택한 다음, 사용할 대기열의 ARN을 입력합니다. 메시지를 보낼 수 있는 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다. 자세한 내용은 [DLQ(Dead Letter Queue)에 권한 부여](eb-rule-dlq.md#eb-dlq-perms) 단원을 참조하십시오. ------ #### [ AWS service ] EventBridge는 지정된 AWS 서비스에 대해 다음 필드를 모두 표시하지 않을 수 있습니다. 1. (선택 사항) 대상 입력 구성의 경우 일치하는 이벤트를 위해 대상으로 전송되는 텍스트를 사용자 지정하는 방법을 선택합니다. 다음 중 하나를 선택합니다. + **일치하는 이벤트** — EventBridge는 원본 소스 이벤트 전체를 대상으로 보냅니다. 기본값입니다. + **일치하는 이벤트의 일부** — EventBridge는 원본 소스 이벤트의 지정된 부분만 대상에 보냅니다. **일치하는 이벤트의 일부를 지정합니다.**에서 EventBridge가 대상으로 전송할 이벤트 부분을 정의하는 JSON 경로를 지정합니다. + **상수(JSON 텍스트)** - EventBridge는 지정된 JSON 텍스트만 대상으로 전송합니다. 원본 소스 이벤트의 어떤 부분도 전송되지 않습니다. **JSON으로 상수를 지정**에서 EventBridge가 이벤트 대신 대상으로 전송할 JSON 텍스트를 지정합니다. + **입력 변환기** - EventBridge가 대상으로 보낼 텍스트를 사용자 지정하도록 입력 변환기를 구성합니다. 자세한 내용은 [Amazon EventBridge 입력 변환](eb-transform-target-input.md) 단원을 참조하십시오. 1. **입력 변환기 구성**을 선택합니다. 1. [EventBridge에서 규칙을 생성할 때 입력 변환기 구성](eb-transform-input-rule.md)의 단계에 따라 입력 변환기를 구성합니다. 1. (선택 사항) **재시도 정책**에서 오류 발생 후 EventBridge가 대상으로의 이벤트 전송을 재시도하는 방법을 지정합니다. + **최대 이벤트 기간** - EventBridge에서 처리되지 않은 이벤트를 유지할 수 있는 최대 시간(시간, 분, 초)을 입력합니다. 기본값은 24시간입니다. + **재시도** - 오류 발생 후 EventBridge가 대상으로 이벤트 전송을 재시도해야 하는 최대 횟수를 입력합니다. 기본값은 185회입니다. 1. (선택 사항) **DLQ(Dead Letter Queue)**에서 표준 Amazon SQS 대기열을 배달 못한 편지 대기열로 사용할지를 선택합니다. 이벤트가 대상에 성공적으로 전달되지 않은 경우 EventBridge는 이 규칙과 일치하는 이벤트를 DLQ(Dead Letter Queue)로 보냅니다. 다음 중 하나를 수행합니다. + 배달 못한 편지 대기열을 사용하지 않으려면 **없음(None)**을 선택합니다. + **현재 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열** 선택을 선택한 다음 드롭다운 목록에서 사용할 대기열을 선택합니다. + **다른 AWS 계정에서 배달 못한 편지 대기열로 사용할 Amazon SQS 대기열 선택**을 선택한 다음, 사용할 대기열의 ARN을 입력합니다. 메시지를 보낼 수 있는 EventBridge 권한을 부여하는 리소스 기반 정책을 대기열에 연결해야 합니다. 자세한 내용은 [DLQ(Dead Letter Queue)에 권한 부여](eb-rule-dlq.md#eb-dlq-perms) 단원을 참조하십시오. ------ 1. (선택 사항) 이 규칙에 다른 대상을 추가하려면 **다른 대상 추가**를 선택합니다. 1. **다음**을 선택합니다. ### 태그 구성 및 규칙 검토 마지막으로 규칙에 원하는 태그를 입력한 다음 규칙을 검토 및 생성합니다. **태그를 구성하고 규칙을 검토 및 생성하려면** 1. (선택 사항)규칙에 대해 하나 이상의 태그를 입력하세요. 자세한 내용은 [Amazon EventBridge에서 리소스 태그 지정](eb-tagging.md) 단원을 참조하십시오. 1. **다음**을 선택합니다. 1. 새 규칙의 세부 정보를 검토합니다. 섹션을 변경하려면 해당 섹션 옆에 있는 **편집** 버튼을 선택합니다. 규칙 세부 정보에 만족하면 **규칙 생성**을 선택합니다. # Amazon EventBridge에서 예약된 규칙(레거시)에 대한 일정 패턴 설정 **참고** 예약된 규칙은 EventBridge의 레거시 기능입니다. EventBridge는 대규모로 예약된 작업을 중앙에서 생성, 실행 및 관리하는 보다 유연하고 강력한 방법인 EventBridge 스케줄러를 제공합니다. EventBridge 스케줄러를 사용하면 반복 패턴에 대해 cron 및 rate 표현식을 사용하여 일정을 만들거나 일회성 간접 호출을 구성할 수 있습니다. 전송을 위한 유연한 기간을 설정하고, 재시도 제한을 정의하고, 실패한 API 간접 호출의 최대 보존 시간을 설정할 수 있습니다. 스케줄러는 사용자 지정이 가능하며 더 광범위한 대상 API 작업 및 AWS 서비스를 통해 예약된 규칙보다 향상된 확장성을 제공합니다. 스케줄러를 사용하여 일정에 따라 대상을 간접적으로 호출하는 것이 좋습니다. 자세한 내용은 [일정 생성](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) 또는 *[EventBridge 스케줄러 사용 설명서를](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)* 참조하세요. EventBridge에서 예약된 규칙을 생성할 때 EventBridge가 규칙을 실행하는 시기를 결정하는 일정 패턴을 지정할 수 있습니다. + *cron* 표현식을 사용하여 특정 시간과 날짜에 규칙을 실행합니다. + *rate* 표현식을 사용하여 규칙을 정기적으로 실행합니다. ## cron 표현식 cron 표현식에는 각각 공백으로 구분되는 필수 필드 6개가 있습니다. **구문** ``` cron(fields) ``` | **필드** | **값** | **와일드카드** | | --- | --- | --- | | Minutes | 0\$159 | , - \$1 / | | 시간 | 0\$123 | , - \$1 / | | 날짜 | 1\$131 | , - \$1 ? / L W | | 월 | 1-12 또는 JAN-DEC | , - \$1 / | | 요일 | 1-7 또는 SUN-SAT | , - \$1 ? L \$1 | | 연도 | 1970\$12199 | , - \$1 / | **와일드카드** + **,**(쉼표) 와일드카드는 추가 값을 포함합니다. ‘월’ 필드에서 JAN, FEB, MAR은 1월, 2월, 3월을 포함한다는 의미입니다. + **-**(대시) 와일드카드는 범위를 지정합니다. ‘일’ 필드에서 1-15는 지정된 달의 1일에서 15일까지 포함한다는 의미입니다. + **\$1**(별표) 와일드카드는 필드의 모든 값을 포함합니다. ‘시간’ 필드에서 **\$1**는 모든 시간을 포함한다는 의미입니다. '날짜' 및 '요일' 필드 모두에서 **\$1**를 사용할 수 없습니다. 필드 중 하나에 사용할 경우 다른 하나에는 반드시 **?**를 사용해야 합니다. + **/**(슬래시) 와일드카드로 증분을 지정합니다. 예를 들어, '분' 필드에 1/10을 입력하면 지정한 시간의 1분부터 시작해서 매 10분 간격을 지정할 수 있습니다(즉, 11분, 21분, 31분 등). + **?**(물음표) 와일드카드는 any를 지정합니다. '날짜' 필드에 **7**을 입력하고 일주일 중 어느 날이라도 괜찮다면 '요일' 필드에는 **?**을 입력합니다. + '날짜' 또는 '요일' 필드에서 **L** 와일드카드로 해당 월 또는 주의 마지막 날을 지정할 수 있습니다. + '날짜' 필드에서는 **W** 와일드카드로 어떤 한 평일을 지정할 수 있습니다. 예를 들어 '날짜' 필드에 **3W**를 입력하면 해당 월의 세 번째 평일에 가장 가까운 날을 지정할 수 있습니다. + '요일' 필드의 **\$1** 와일드카드는 그 달에 속한 정해진 요일의 특정 인스턴스를 지정합니다. 예를 들어, 3\$12는 그 달의 두 번째 화요일입니다. 3은 각 주의 셋째 날이므로 화요일을 나타내고 2는 그 달의 두 번째 해당 요일입니다. **참고** '\$1' 문자를 사용하는 경우 요일(day-of-week) 필드에 하나의 표현식만 정의할 수 있습니다. 예를 들어 `"3#1,6#3"`은(는) 두 개의 표현식으로 해석되기 때문에 유효하지 않습니다. **제한 사항** + 같은 cron 표현식에서 '날짜' 및 '요일' 필드를 지정할 수 없습니다. 필드 중 하나에 값 또는 \$1(별표)를 지정하는 경우 다른 필드에는 **?**(물음표)를 사용해야 합니다. + 1분보다 빠른 속도로 이어지는 cron 표현식은 지원되지 않습니다. **예제** 예약에 따라 규칙을 생성할 때는 다음과 같이 동일한 cron 문자열을 사용할 수 있습니다. | 분 | 시간 | 일 | 월 | 요일 | 연도 | 의미 | | --- | --- | --- | --- | --- | --- | --- | | 0 | 10 | \$1 | \$1 | ? | \$1 | 매일 오전 10시(UTC\$10)에 실행 | | 15 | 12 | \$1 | \$1 | ? | \$1 | 매일 오후 12시 15분(UTC\$10)에 실행 | | 0 | 18 | ? | \$1 | 월-금 | \$1 | 매주 월요일부터 금요일까지 오후 6시(UTC\$10)에 실행 | | 0 | 8 | 1 | \$1 | ? | \$1 | 매월 1일 오전 8시(UTC\$10)에 실행 | | 0/15 | \$1 | \$1 | \$1 | ? | \$1 | 15분마다 실행 | | 0/10 | \$1 | ? | \$1 | 월-금 | \$1 | 월요일부터 금요일까지 10분마다 실행 | | 0/5 | 8\$117 | ? | \$1 | 월-금 | \$1 | 월요일부터 금요일까지 오전 8시부터 오후 5시 55분(UTC\$10) 사이에 5분마다 실행 | | 0/30 | 20-2 | ? | \$1 | 월-금 | \$1 | 시작일 오후 10시부터 다음 날 오전 2시까지 월요일부터 금요일까지 30분마다 실행(UTC) 월요일 오전 12시부터 오전 2시까지 실행합니다(UTC). | 다음 예에서는 매일 오후 12시(UTC\$10)에 실행되는 규칙을 생성합니다. ``` aws events put-rule --schedule-expression "cron(0 12 * * ? *)" --name MyRule1 ``` 다음 예에서는 매일 오후 2시 5분과 오후 2시 35분(UTC\$10)에 실행되는 규칙을 생성합니다. ``` aws events put-rule --schedule-expression "cron(5,35 14 * * ? *)" --name MyRule2 ``` 다음 예에서는 2019년부터 2022년까지 매월 마지막 금요일 오전 10시 15분(UTC\$10)에 실행되는 규칙을 생성합니다. ``` aws events put-rule --schedule-expression "cron(15 10 ? * 6L 2019-2022)" --name MyRule3 ``` ## rate 표현식 *rate 표현식*은 예약된 이벤트 규칙을 생성할 때 시작되며, 정의된 일정에 따라 실행됩니다. rate 표현식에는 각각 공백으로 구분되는 필수 필드 2개가 있습니다. **구문** ``` rate(value unit) ``` 값 양수. 단위 시간 단위. 1의 값(예: `minute`)과 1을 초과하는 값(예: `minutes`)은 서로 다른 단위가 필요합니다. 유효값: 분 \$1 분 \$1 시간 \$1 시간 \$1 일 \$1 일 **제한 사항** 값이 1과 같을 경우에는 단위가 단수여야 합니다. 값이 1보다 크면 단위는 복수여야 합니다. 예를 들어, rate(1 hours)와 rate(5 hour)는 잘못된 식이며, rate(1 hour)와 rate(5 hours)가 유효한 식입니다. **예제** 다음 예제에서는 `put-rule` 명령과 함께 AWS CLI rate 표현식을 사용하는 방법을 보여줍니다. 첫 번째 예제는 1분마다 규칙을 트리거하고, 두 번째 예제는 5분마다 규칙을 트리거하며, 다음은 한 시간에 한 번 트리거하고, 마지막 예제는 하루에 한 번 트리거합니다. ``` aws events put-rule --schedule-expression "rate(1 minute)" --name MyRule2 ``` ``` aws events put-rule --schedule-expression "rate(5 minutes)" --name MyRule3 ``` ``` aws events put-rule --schedule-expression "rate(1 hour)" --name MyRule4 ``` ``` aws events put-rule --schedule-expression "rate(1 day)" --name MyRule5 ```