

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

# 를 사용하여 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) 단원을 참조하십시오.

지정된 일정(현지 시간 기준 매주 월요일\$1금요일 오후 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
```