• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.
# 유지 관리 기간 예약 및 유효 기간 옵션
유지 관리 기간을 생성할 때 [Cron or rate expression(Cron 또는 Rate 표현식)](reference-cron-and-rate-expressions.md)을 사용하여 유지 관리 기간 실행 빈도를 지정해야 합니다. 선택적으로 유지 관리 기간을 정기 일정에 따라 실행할 수 있는 날짜 범위와 정규 일정의 기준으로 사용할 시간대를 지정할 수도 있습니다.
하지만 시간대 옵션과 시작 날짜 및 종료 날짜 옵션은 서로 영향을 주지 않습니다. 시간대에 대한 오프셋을 적용하거나 적용하지 않고 지정한 시작 날짜와 종료 날짜는 유지 관리 기간이 일정에 따라 실행될 수 있는 *유효 기간*만 결정합니다. 시간대 옵션은 유지 관리 기간 일정이 유효 기간 *동안* 기반으로 하는 국제 시간대를 결정합니다.
**참고**
시작 날짜와 종료 날짜를 ISO-8601 타임스탬프 형식으로 지정합니다. 예: `2021-04-07T14:29:00-08:00`
시간대를 IANA(Internet Assigned Number Authority) 형식으로 지정합니다. 예: `America/Chicago`, `Europe/Berlin`, `Asia/Tokyo` 등
**Topics**
+ [예제 1: 유지 관리 기간 시작 날짜 지정](#schedule-example-start-date)
+ [예제 2: 유지 관리 기간 시작 날짜 및 종료 날짜 지정](#schedule-example-start-end-date)
+ [예제 3: 한 번만 실행되는 유지 관리 기간 생성](#schedule-example-one-time)
+ [예제 4: 유지 관리 기간에 대한 일정 오프셋 일 수 지정](#schedule-example-schedule-offset)
## 예제 1: 유지 관리 기간 시작 날짜 지정
AWS Command Line Interface(AWS CLI)에서 다음 옵션을 사용하여 유지 관리 기간을 생성한다고 가정합니다.
+ `--start-date 2021-01-01T00:00:00-08:00`
+ `--schedule-timezone "America/Los_Angeles"`
+ `--schedule "cron(0 09 ? * WED *)"`
예:
------
#### [ Linux & macOS ]
```
aws ssm create-maintenance-window \
--name "My-LAX-Maintenance-Window" \
--allow-unassociated-targets \
--duration 3 \
--cutoff 1 \
--start-date 2021-01-01T00:00:00-08:00 \
--schedule-timezone "America/Los_Angeles" \
--schedule "cron(0 09 ? * WED *)"
```
------
#### [ Windows ]
```
aws ssm create-maintenance-window ^
--name "My-LAX-Maintenance-Window" ^
--allow-unassociated-targets ^
--duration 3 ^
--cutoff 1 ^
--start-date 2021-01-01T00:00:00-08:00 ^
--schedule-timezone "America/Los_Angeles" ^
--schedule "cron(0 09 ? * WED *)"
```
------
즉, 유지 관리 기간의 첫 번째 실행은 지정된 시작 날짜 및 시간, 즉 2021년 1월 1일 금요일 오전 12:00(미국 태평양 표준시) *후*까지 수행되지 않습니다. 이 시간대는 UTC 시간보다 8시간 늦습니다. 이 경우 기간의 시작 날짜와 시간이 유지 관리 기간이 처음 실행되는 시간을 나타내지 않습니다. 종합하면 `--schedule-timezone` 및 `--schedule` 값은 유지 관리 기간을 매주 수요일 오전 9시(미국 태평양 표준시)(IANA 형식으로 "미국/로스앤젤레스"로 표시됨)에 실행합니다. 허용 기간 중 첫 번째 실행 시간은 2021년 1월 4일 수요일 오전 9시(미국 태평양 표준시)입니다.
## 예제 2: 유지 관리 기간 시작 날짜 및 종료 날짜 지정
다음에는 아래 옵션을 사용하여 유지 관리 기간을 생성한다고 가정합니다.
+ `--start-date 2019-01-01T00:03:15+09:00`
+ `--end-date 2019-06-30T00:06:15+09:00`
+ `--schedule-timezone "Asia/Tokyo"`
+ `--schedule "rate(7 days)"`
예:
------
#### [ Linux & macOS ]
```
aws ssm create-maintenance-window \
--name "My-NRT-Maintenance-Window" \
--allow-unassociated-targets \
--duration 3 \
--cutoff 1 \
--start-date 2019-01-01T00:03:15+09:00 \
--end-date 2019-06-30T00:06:15+09:00 \
--schedule-timezone "Asia/Tokyo" \
--schedule "rate(7 days)"
```
------
#### [ Windows ]
```
aws ssm create-maintenance-window ^
--name "My-NRT-Maintenance-Window" ^
--allow-unassociated-targets ^
--duration 3 ^
--cutoff 1 ^
--start-date 2019-01-01T00:03:15+09:00 ^
--end-date 2019-06-30T00:06:15+09:00 ^
--schedule-timezone "Asia/Tokyo" ^
--schedule "rate(7 days)"
```
------
이 유지 관리 기간에 대한 허용 기간은 2019년 1월 1일 오전 3시 15분(일본 표준시)에 시작됩니다. 이 유지 관리 기간에 대한 유효 기간은 2019년 6월 30일 일요일 오전 6시 15분(일본 표준시)에 종료됩니다. 이 시간대는 UTC 시간보다 9시간 빠릅니다. 종합하면 `--schedule-timezone` 및 `--schedule` 값은 유지 관리 기간을 매주 화요일 오전 3시 15분(일본 표준시)(IANA 형식으로 "아시아/도쿄"로 표시됨)에 실행합니다. 이유는 유지 관리 기간이 7일마다 실행되고 1월 1일 화요일 오전 3시 15분에 활성화되기 때문입니다. 마지막 실행 시간은 2019년 6월 25일 화요일 오전 3시 15분(일본 표준시)입니다. 이 시간은 허용된 유지 관리 기간이 종료되기 이전의 마지막 화요일이며 5일 후에 유효 기간이 종료됩니다.
## 예제 3: 한 번만 실행되는 유지 관리 기간 생성
이제 이 옵션으로 유지 관리 기간을 생성합니다.
+ `--schedule "at(2020-07-07T15:55:00)"`
예:
------
#### [ Linux & macOS ]
```
aws ssm create-maintenance-window \
--name "My-One-Time-Maintenance-Window" \
--schedule "at(2020-07-07T15:55:00)" \
--duration 5 \
--cutoff 2 \
--allow-unassociated-targets
```
------
#### [ Windows ]
```
aws ssm create-maintenance-window ^
--name "My-One-Time-Maintenance-Window" ^
--schedule "at(2020-07-07T15:55:00)" ^
--duration 5 ^
--cutoff 2 ^
--allow-unassociated-targets
```
------
이 유지 관리 기간은 2020년 7월 7일 오후 3시 55분(UTC 시간)에 한 번만 실행됩니다. 유지 관리 기간은 필요에 따라 최대 5시간 동안 실행하도록 허용되지만, 유지 관리 기간 종료 2시간 전에는 새 태스크를 시작할 수 없습니다
## 예제 4: 유지 관리 기간에 대한 일정 오프셋 일 수 지정
이제 이 옵션으로 유지 관리 기간을 생성합니다.
```
--schedule-offset 2
```
예:
------
#### [ Linux & macOS ]
```
aws ssm create-maintenance-window \
--name "My-Cron-Offset-Maintenance-Window" \
--schedule "cron(0 30 23 ? * TUE#3 *)" \
--duration 4 \
--cutoff 1 \
--schedule-offset 2 \
--allow-unassociated-targets
```
------
#### [ Windows ]
```
aws ssm create-maintenance-window ^
--name "My-Cron-Offset-Maintenance-Window" ^
--schedule "cron(0 30 23 ? * TUE#3 *)" ^
--duration 4 ^
--cutoff 1 ^
--schedule-offset 2 ^
--allow-unassociated-targets
```
------
일정 오프셋은 유지 관리 기간을 실행하기 전에 CRON 표현식에 의해 지정된 날짜 및 시간 이후에 대기할 일 수입니다.
위의 예에서 CRON 표현식은 매월 셋째 화요일 오후 11:30에 실행되도록 유지 관리 기간을 예약합니다.
```
--schedule "cron(0 30 23 ? * TUE#3 *)
```
그러나 `--schedule-offset 2`를 포함하면 매월 셋째 화요일 2일 *후* 오후 11시 30분까지 유지 관리 기간이 실행되지 않을 것임을 의미합니다.
일정 오프셋은 CRON 표현식에서만 지원됩니다.
**추가 정보**
+ [참조: Systems Manager용 Cron 및 Rate 표현식](reference-cron-and-rate-expressions.md)
+ [콘솔을 사용하여 유지 관리 기간 생성](sysman-maintenance-create-mw.md)
+ [자습서: AWS CLI를 사용한 유지 관리 기간 생성 및 구성](maintenance-windows-cli-tutorials-create.md)
+ *AWS Systems Manager API Reference*의 [CreateMaintenanceWindow](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CreateMaintenanceWindow.html)
+ **AWS CLI 명령 레퍼런스 AWS Systems Manager 섹션의 [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-maintenance-window.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-maintenance-window.html)
+ IANA 웹 사이트의 [시간대 데이터베이스](https://www.iana.org/time-zones)