기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# EventBridge Scheduler에서 일정 그룹 관리
*일정 그룹*은 일정을 구성하는 데 사용하는 Amazon EventBridge 스케줄러 리소스입니다.
AWS 계정에는 `default` 스케줄러 그룹이 함께 제공됩니다. 새 일정을 `default` 그룹 또는 직접 만들고 관리하는 일정 그룹과 연결할 수 있습니다. AWS 계정에서 최대 [500개의 일정 그룹](https://docs.aws.amazon.com/scheduler/latest/UserGuide/scheduler-quotas.html)을 만들 수 있습니다. EventBridge 스케줄러를 사용하면 [태그](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)를 적용하여 개별 일정 대신 일정 그룹을 구성할 수 있습니다.
*태그*는 대소문자를 구분하는 키와 사용자가 정의하는 대소문자를 구분하는 값으로 구성된 레이블입니다. 태그를 생성하여 용도, 소유자 또는 환경 기준으로 일정을 분류할 수 있습니다. 예를 들어, `environment:production` 태그를 사용하여 일정이 속한 환경을 식별할 수 있습니다.
**중요**
개인 식별 정보(PII)나 기타 기밀 정보 또는 민감한 정보를 태그에 추가하지 않습니다. 청구를 비롯한 여러 AWS 서비스에서 태그에 액세스할 수 있습니다. 태그는 개인 데이터나 민감한 데이터에 사용하기 위한 것이 아닙니다.
일정 그룹에는 **활성** 및 **삭제**라는 두 가지 [상태](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_GetScheduleGroup.html#scheduler-GetScheduleGroup-response-State)가 있을 수 있습니다.
그룹을 처음 생성하면 그룹이 기본적으로 `ACTIVE`입니다. `ACTIVE` 그룹에 일정을 추가할 수 있습니다. 그룹을 삭제하면 EventBridge 스케줄러가 관련 일정 삭제를 완료할 때까지 상태가 `DELETING`으로 변경됩니다. EventBridge 스케줄러가 그룹에서 일정을 삭제한 후에는 해당 그룹을 사용자 계정에서 더 이상 사용할 수 없습니다.
다음 항목을 사용하여 일정 그룹을 만들고 여기에 태그를 적용하십시오. 또한 일정을 그룹과 연결합니다. 마지막으로 그룹을 삭제합니다.
**Topics**
+ [EventBridge Scheduler에서 일정 그룹 생성](managing-schedule-group-create.md)
+ [EventBridge Scheduler에서 일정 그룹 삭제](managing-schedule-group-delete.md)
+ [관련 리소스](#managing-schedule-group-related-resources)
# EventBridge Scheduler에서 일정 그룹 생성
일정 그룹과 태그 지정을 사용하여 공통 목적을 공유하거나 동일한 환경에 속하는 일정을 구성할 수 있습니다. 다음 단계에서는 새 일정 그룹을 작성하고 태그를 사용하여 레이블을 지정합니다. 그런 다음 새 일정을 해당 그룹에 연결합니다.
**참고**
그룹을 만든 후에는 해당 그룹에서 일정을 제거하거나 일정을 다른 그룹에 연결할 수 없습니다. 일정을 처음 만들 때만 일정을 그룹과 연결할 수 있습니다.
## 1단계: 새 일정 그룹 생성
다음 주제에서는 새 일정 그룹을 작성하고 이 그룹에 `environment:development` 태그를 사용하여 레이블을 지정하는 방법에 대해 설명합니다.
------
#### [ AWS Management Console ]
**AWS Management Console를 사용하여 새 그룹을 생성하려면**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)에서 Amazon EventBridge 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **일정 그룹**을 선택합니다.
1. 일정 그룹 페이지에서 **일정 그룹 생성**을 선택합니다.
1. **일정 그룹 세부 정보** 섹션의 **이름**에 그룹 이름을 입력합니다. 예를 들어 **TestGroup**입니다.
1. **태그** 섹션에서 다음을 수행합니다.
1. **새로운 태그 추가**를 선택합니다.
1. **키**에는 이 키에 할당하려는 이름을 입력합니다. 이 자습서에서 이 일정 그룹이 속한 환경에 레이블을 지정하려면 **environment**를 입력하십시오.
1. **값*(선택 사항)***에 키에 할당할 값을 입력합니다. 이 자습서에서는 환경 키에 **development** 값을 입력합니다.
**참고**
그룹을 생성한 후 그룹에 추가 태그를 추가할 수 있습니다.
1. 종료하려면 **일정 그룹 생성**을 선택합니다. 새 그룹이 **일정 그룹** 목록에 표시됩니다.
1. (선택 사항) 그룹을 편집하거나 그룹 태그를 관리하려면 새 그룹의 확인란을 선택하고 **편집**을 선택합니다.
**참고**
`default` 일정 그룹은 편집할 수 없습니다.
------
#### [ AWS CLI ]
**AWS CLI를 사용하여 새 그룹을 생성하려면**
1. 새 명령 프롬프트 창을 엽니다.
1. AWS Command Line Interface(AWS CLI)에서 다음 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/create-schedule-group.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/create-schedule-group.html) 명령을 입력하여 새 그룹을 생성합니다. 이 명령은 태그가 `environment:development` 하나인 그룹을 생성합니다. 이 태그 또는 유사한 태그 지정 시스템을 사용하여 일정 그룹이 속한 환경에 따라 일정 그룹에 레이블을 지정할 수 있습니다.
일정 이름과 태그 키 및 값을 사용자 정보로 바꾸십시오.
```
$ aws scheduler create-schedule-group --name TestGroup --tags Key=environment,Value=development
```
------
기본적으로 새 그룹은 `ACTIVE` 상태입니다. 이제 새로 만든 그룹에 새 일정을 연결할 수 있습니다.
## 2단계: 일정을 그룹과 연결하기
다음 단계를 사용하여 [이전 단계에서](#create-schedule-group) 만든 그룹에 새 일정을 연결합니다.
------
#### [ AWS Management Console ]
**AWS Management Console를 사용하여 일정을 그룹과 연결하려면**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)에서 Amazon EventBridge 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **일정**을 선택합니다.
1. **일정** 테이블에서 **일정 만들기**를 선택하여 새 일정을 만듭니다.
1. **일정 세부 정보 지정** 페이지의 **일정 그룹**에 대해 드롭다운 목록에서 새 그룹의 이름을 선택합니다. 예를 들어, `TestGroup`을 선택합니다.
1. 일정 패턴, 대상, 설정을 지정한 다음 **일정 검토 및 저장** 페이지에서 선택 사항을 검토하십시오. 새 일정 구성에 대한 자세한 내용은 [EventBridge 스케줄러 시작하기](getting-started.md) 섹션을 참조하세요.
1. 일정을 완료하고 저장하려면 **일정 저장**을 선택합니다.
------
#### [ AWS CLI ]
**AWS CLI를 사용하여 일정을 그룹과 연결하려면**
1. 새 명령 프롬프트 창을 엽니다.
1. AWS Command Line Interface(AWS CLI)에서 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/create-schedule.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/create-schedule.html) 명령을 입력합니다. 이렇게 하면 일정이 생성되고 [이전 단계](#create-schedule-group)에서 만든 `sqs-test-schedule`이라는 그룹과 일정이 연결됩니다. 이 일정은 템플릿 기반 [Amazon SQS](managing-targets-templated.md#managing-targets-templated-sqs) 대상 유형을 사용하여 `SendMessage` 작업을 간접적으로 호출합니다. 일정 이름, 대상 및 그룹 이름을 사용자 정보로 대체하십시오.
```
$ aws scheduler create-schedule --name sqs-test-schedule --schedule-expression 'rate(5 minutes)' \
--target '{"RoleArn": "ROLE_ARN", "Arn": "QUEUE_ARN", "Input": "TEST_PAYLOAD" }' \
--group-name TestGroup
--flexible-time-window '{ "Mode": "OFF"}'
```
------
이제 새 일정이 `TestGroup` 일정 그룹과 연결됩니다.
# EventBridge Scheduler에서 일정 그룹 삭제
다음에서 AWS Management Console 및 AWS Command Line Interface를 사용하여 일정 그룹을 삭제하는 방법을 알아볼 수 있습니다. 그룹을 삭제하면 EventBridge 스케줄러가 그룹 내의 모든 일정을 삭제하기 전까지는 그룹이 `DELETING` 상태가 됩니다. EventBridge 스케줄러가 그룹에서 일정을 삭제한 후에는 해당 그룹을 사용자 계정에서 더 이상 사용할 수 없습니다.
**참고**
그룹을 만든 후에는 해당 그룹에서 일정을 제거하거나 일정을 다른 그룹에 연결할 수 없습니다. 일정을 처음 만들 때만 일정을 그룹과 연결할 수 있습니다.
------
#### [ AWS Management Console ]
**AWS Management Console를 사용하여 그룹을 삭제하려면**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)에서 Amazon EventBridge 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **일정 그룹**을 선택합니다.
1. **일정 그룹** 페이지에서 현재 AWS 리전의 기존 그룹 목록에서 삭제하려는 그룹을 찾습니다. 찾고 있는 그룹이 보이지 않으면 다른 AWS 리전을 선택하세요.
**참고**
**기본** 그룹은 삭제하거나 편집할 수 없습니다.
1. 삭제하려는 그룹의 확인란을 선택합니다.
1. **삭제**를 선택합니다.
1. **일정 그룹 삭제** 대화 상자에서 그룹 이름을 입력하여 선택을 확인한 다음 **삭제**를 선택합니다.
1. **일정 그룹** 목록에서 **상태** 열이 변경되어 그룹이 현재 **삭제 중**임을 나타냅니다. EventBridge 스케줄러가 그룹과 관련된 모든 일정을 삭제할 때까지 그룹은 이 상태를 유지합니다.
1. 목록을 새로 고치고 그룹이 삭제되었는지 확인하려면 **새로 고침** 아이콘을 선택합니다.
------
#### [ AWS CLI ]
**AWS CLI를 사용하여 그룹을 삭제하려면**
1. 새 명령 프롬프트 창을 엽니다.
1. AWS Command Line Interface(AWS CLI)에서 다음 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/delete-schedule-group.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/delete-schedule-group.html) 명령을 입력하여 일정 그룹을 삭제합니다. `--name`의 값을 사용자 정보로 바꾸십시오.
```
$ aws scheduler delete-schedule-group --name TestGroup
```
성공한 경우 이 AWS CLI 작업은 응답을 반환하지 않습니다.
1. 그룹이 `DELETING` 상태에 있는지 확인하려면 다음 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/get-schedule-group.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/get-schedule-group.html) 명령을 실행합니다.
```
$ aws scheduler get-schedule-group --name TestGroup
```
성공적으로 실행되면, 다음과 비슷한 출력이 표시됩니다.
```
{
"Arn": "arn:aws::scheduler:us-west-2:123456789012:schedule-group/TestGroup",
"CreationDate": "2023-01-01T09:00:00.000000-07:00",
"LastModificationDate": "2023-01-01T09:00:00.000000-07:00",
"Name": "TestGroup",
"State": "DELETING"
}
```
EventBridge 스케줄러는 그룹과 관련된 일정을 삭제한 후 그룹을 삭제합니다. `get-schedule-group`을 다시 실행하면 `ResourceNotFoundException` 응답을 받게 됩니다.
```
An error occurred (ResourceNotFoundException) when calling the GetScheduleGroup operation: Schedule group TestGroup does not exist.
```
------
## 관련 리소스
일정 그룹에 대한 자세한 내용은 다음 리소스를 참조하세요.
+ *EventBridge 스케줄러 API 참조*의 [CreateScheduleGroup](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_CreateScheduleGroup.html) 작업.
+ *EventBridge 스케줄러 API 참조*의 [DeleteScheduleGroup](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_DeleteScheduleGroup.html) 작업.