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

# 를 사용하여 Application Auto Scaling에 예약된 작업 생성 AWS CLI
<a name="create-scheduled-actions"></a>

다음 예제에서는 AWS CLI [put-scheduled-action](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scheduled-action.html) 명령을 사용하여 예약된 작업을 생성하는 방법을 보여줍니다. 새로운 용량을 지정할 때 최소 용량, 최대 용량 또는 둘 다 지정할 수 있습니다.

이러한 예제에서는 Application Auto Scaling과 통합되는 일부 서비스에 규모 조정 가능 대상을 사용합니다. 다른 규모 조정 가능 대상을 사용하려면 `--service-namespace`에 네임스페이스, `--scalable-dimension`에 규모 조정 가능 차원, `--resource-id`에 리소스 ID를 지정합니다.

를 사용할 때는 명령이 프로파일에 대해 AWS 리전 구성된에서 실행된다는 점을 AWS CLI기억하세요. 다른 리전에서 명령을 실행하려는 경우 프로필의 기본 리전을 변경하거나 명령에 `--region` 파라미터를 사용합니다.

**Topics**
+ [한 번만 발생하는 예약된 작업 생성](#one-time-schedule)
+ [반복되는 간격으로 실행되는 예약된 작업 만들기](#recurrence-schedule-rate)
+ [반복되는 일정으로 실행되는 예약된 작업 생성](#recurrence-schedule-cron)
+ [시간대를 지정하는 일회성 예약된 작업 만들기](#one-time-schedule-set-time-zone)
+ [시간대를 지정하는 반복 예약 작업 생성](#recurring-schedule-set-time-zone)

## 한 번만 발생하는 예약된 작업 생성
<a name="one-time-schedule"></a>

지정된 날짜 및 시간에 확장 가능한 대상을 한 번만 자동으로 조정하려면 `--schedule "at({{yyyy-mm-ddThh:mm:ss}})"` 옵션을 사용합니다.

**Example 예: 일회성 스케일 아웃.**  
다음은 특정 날짜 및 시간에 용량을 확장하기 위해 예약된 작업을 생성하는 예제입니다.  
`--schedule`(2021년 3월 31일, 오후 10시(UTC 기준))에 지정된 날짜 및 시간에, `MinCapacity`에 지정된 값이 현재 용량보다 큰 경우 Application Auto Scaling은 `MinCapacity`로 확장합니다.  
**Linux, macOS 또는 Unix**  

```
aws application-autoscaling put-scheduled-action --service-namespace {{custom-resource}} \
  --scalable-dimension {{custom-resource:ResourceType:Property}} \
  --resource-id {{file://~/custom-resource-id.txt}} \
  --scheduled-action-name {{scale-out}} \
  --schedule "at({{2021-03-31T22:00:00}})" \
  --scalable-target-action MinCapacity={{3}}
```
**Windows**  

```
aws application-autoscaling put-scheduled-action --service-namespace {{custom-resource}} ^
  --scalable-dimension {{custom-resource:ResourceType:Property}} ^
  --resource-id {{file://~/custom-resource-id.txt}} ^
  --scheduled-action-name {{scale-out}} ^
  --schedule "at({{2021-03-31T22:00:00}})" ^
  --scalable-target-action MinCapacity={{3}}
```
이 예약된 작업이 실행될 때 최대 용량이 최소 용량에 지정된 값보다 작은 경우 최소 용량뿐만 아니라 새로운 최소 및 최대 용량을 지정해야 합니다.

**Example 예: 일회성 축소.**  
다음은 특정 날짜 및 시간에 용량을 축소하기 위해 예약된 작업을 생성하는 예제입니다.  
`--schedule`(2021년 3월 31일, 오후 10시 30분(UTC 기준))에 지정된 날짜 및 시간에, `MaxCapacity`에 지정된 값이 현재 용량보다 큰 경우 Application Auto Scaling은 `MaxCapacity`로 축소합니다.  
**Linux, macOS 또는 Unix**  

```
aws application-autoscaling put-scheduled-action --service-namespace {{custom-resource}} \
  --scalable-dimension {{custom-resource:ResourceType:Property}} \
  --resource-id {{file://~/custom-resource-id.txt}} \
  --scheduled-action-name {{scale-in}} \
  --schedule "at({{2021-03-31T22:30:00}})" \
  --scalable-target-action MinCapacity={{0}},MaxCapacity={{0}}
```
**Windows**  

```
aws application-autoscaling put-scheduled-action --service-namespace {{custom-resource}} ^
  --scalable-dimension {{custom-resource:ResourceType:Property}} ^
  --resource-id {{file://~/custom-resource-id.txt}} ^
  --scheduled-action-name {{scale-in}} ^
  --schedule "at({{2021-03-31T22:30:00}})" ^
  --scalable-target-action MinCapacity={{0}},MaxCapacity={{0}}
```

## 반복되는 간격으로 실행되는 예약된 작업 만들기
<a name="recurrence-schedule-rate"></a>

반복되는 간격으로 조정을 예약하려면 `--schedule "rate({{value unit}})"` 옵션을 사용합니다. 값은 양의 정수여야 합니다. 단위는 `minute`, `minutes`, `hour`, `hours`, `day` 또는 `days`가 될 수 있습니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Rate 표현식](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html#eb-rate-expressions)을 참조하세요.

다음은 rate 표현식을 사용하는 예약된 작업의 예제입니다.

지정된 일정에 따라(2021년 1월 30일 오후 12시에 시작하여 2021년 1월 31일 오후 10시(UTC 기준)에 끝나는 5시간마다) `MinCapacity`에 지정된 값이 현재 용량보다 큰 경우, Application Auto Scaling이 `MinCapacity`로 확장합니다. `MaxCapacity`에 지정된 값이 현재 용량보다 작을 경우 Application Auto Scaling은 `MaxCapacity`로 축소합니다.

**Linux, macOS 또는 Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace {{ecs}} \
  --scalable-dimension {{ecs:service:DesiredCount}} \
  --resource-id {{service/my-cluster/my-service}} \
  --scheduled-action-name {{my-recurring-action}} \
  --schedule "rate({{5 hours}})" \
  --start-time {{2021-01-30T12:00:00}} \
  --end-time {{2021-01-31T22:00:00}} \
  --scalable-target-action MinCapacity={{3}},MaxCapacity={{10}}
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace {{ecs}} ^
  --scalable-dimension {{ecs:service:DesiredCount}} ^
  --resource-id {{service/my-cluster/my-service}} ^
  --scheduled-action-name {{my-recurring-action}} ^
  --schedule "rate({{5 hours}})" ^
  --start-time {{2021-01-30T12:00:00}} ^
  --end-time {{2021-01-31T22:00:00}} ^
  --scalable-target-action MinCapacity={{3}},MaxCapacity={{10}}
```

## 반복되는 일정으로 실행되는 예약된 작업 생성
<a name="recurrence-schedule-cron"></a>

반복되는 일정으로 조정을 예약하려면 `--schedule "cron({{fields}})"` 옵션을 사용합니다. 자세한 내용은 [Application Auto Scaling을 사용하여 반복 조정 작업 예약](scheduled-scaling-using-cron-expressions.md) 단원을 참조하십시오.

다음은 cron 표현식을 사용하는 예약된 작업의 예제입니다.

지정된 일정(UTC 기준 매일 오전 9시)에 `MinCapacity`에 지정된 값이 현재 용량보다 큰 경우 Application Auto Scaling은 `MinCapacity`로 확장합니다. `MaxCapacity`에 지정된 값이 현재 용량보다 작을 경우 Application Auto Scaling은 `MaxCapacity`로 축소합니다.

**Linux, macOS 또는 Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace {{appstream}} \
  --scalable-dimension {{appstream:fleet:DesiredCapacity}} \
  --resource-id {{fleet/sample-fleet}} \
  --scheduled-action-name {{my-recurring-action}} \
  --schedule "cron({{0 9 * * ? *}})" \
  --scalable-target-action MinCapacity={{10}},MaxCapacity={{50}}
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace {{appstream}} ^
  --scalable-dimension {{appstream:fleet:DesiredCapacity}} ^
  --resource-id {{fleet/sample-fleet}} ^
  --scheduled-action-name {{my-recurring-action}} ^
  --schedule "cron({{0 9 * * ? *}})" ^
  --scalable-target-action MinCapacity={{10}},MaxCapacity={{50}}
```

## 시간대를 지정하는 일회성 예약된 작업 만들기
<a name="one-time-schedule-set-time-zone"></a>

예약된 작업은 기본적으로 UTC 표준 시간대로 설정됩니다. 다른 시간대를 지정하려면 `--timezone` 옵션을 선택하고 시간대의 정식 이름(예: `America/New_York`)을 지정합니다. 자세한 내용은 [https://www.joda.org/joda-time/timezones.html](https://www.joda.org/joda-time/timezones.html)을 참조하세요. [put-scheduled-action](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scheduled-action.html)을 호출할 때 지원되는 IANA 시간대에 대한 정보를 제공합니다.

다음은 특정 날짜 및 시간에 용량을 조정하기 위해 예약된 작업을 생성할 때 `--timezone` 옵션을 사용하는 예제입니다.

`--schedule`(2021년 1월 31일, 오후 5시(현지 시간))에 지정된 날짜 및 시간에, `MinCapacity`에 지정된 값이 현재 용량보다 큰 경우 Application Auto Scaling은 `MinCapacity`로 확장합니다. `MaxCapacity`에 지정된 값이 현재 용량보다 작을 경우 Application Auto Scaling은 `MaxCapacity`로 축소합니다.

**Linux, macOS 또는 Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace {{comprehend}} \
  --scalable-dimension {{comprehend:document-classifier-endpoint:DesiredInferenceUnits}} \
  --resource-id {{arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE}} \
  --scheduled-action-name {{ my-one-time-action}} \
  --schedule "at({{2021-01-31T17:00:00}})" --timezone "{{America/New_York}}" \
  --scalable-target-action MinCapacity={{1}},MaxCapacity={{3}}
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace {{comprehend}} ^
  --scalable-dimension {{comprehend:document-classifier-endpoint:DesiredInferenceUnits}} ^
  --resource-id {{arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE}} ^
  --scheduled-action-name {{ my-one-time-action}} ^
  --schedule "at({{2021-01-31T17:00:00}})" --timezone "{{America/New_York}}" ^
  --scalable-target-action MinCapacity={{1}},MaxCapacity={{3}}
```

## 시간대를 지정하는 반복 예약 작업 생성
<a name="recurring-schedule-set-time-zone"></a>

다음은 용량을 조정하기 위해 반복 예약 작업을 생성할 때 `--timezone` 옵션을 사용하는 예입니다. 자세한 내용은 [Application Auto Scaling을 사용하여 반복 조정 작업 예약](scheduled-scaling-using-cron-expressions.md) 단원을 참조하십시오.

지정된 일정(현지 시간 기준 매주 월요일\~금요일 오후 6시)에 `MinCapacity`에 지정된 값이 현재 용량보다 큰 경우 Application Auto Scaling은 `MinCapacity`로 확장합니다. `MaxCapacity`에 지정된 값이 현재 용량보다 작을 경우 Application Auto Scaling은 `MaxCapacity`로 축소합니다.

**Linux, macOS 또는 Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace {{lambda}} \
  --scalable-dimension {{lambda:function:ProvisionedConcurrency}} \
  --resource-id {{function:my-function:BLUE}} \
  --scheduled-action-name {{my-recurring-action}} \
  --schedule "cron({{0 18 ? * MON-FRI *}})" --timezone "{{Etc/GMT+9}}" \
  --scalable-target-action MinCapacity={{10}},MaxCapacity={{50}}
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace {{lambda}} ^
  --scalable-dimension {{lambda:function:ProvisionedConcurrency}} ^
  --resource-id {{function:my-function:BLUE}} ^
  --scheduled-action-name {{my-recurring-action}} ^
  --schedule "cron({{0 18 ? * MON-FRI *}})" --timezone "{{Etc/GMT+9}}" ^
  --scalable-target-action MinCapacity={{10}},MaxCapacity={{50}}
```