翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用して 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 CLI、コマンドはプロファイル用に AWS リージョン 設定された で実行されることに注意してください。別のリージョンでコマンドを実行する場合は、プロファイルのデフォルトのリージョンを変更するか、コマンドに `--region` パラメータを使用します。

**Topics**
+ [1 回だけ実行される、スケジュールされたアクションを作成する](#one-time-schedule)
+ [定期的な間隔で実行されるスケジュールされたアクションを作成する](#recurrence-schedule-rate)
+ [定期的なスケジュールで実行されるスケジュールされたアクションを作成する](#recurrence-schedule-cron)
+ [タイムゾーンを指定する 1 回限りのスケジュールされたアクションを作成する](#one-time-schedule-set-time-zone)
+ [タイムゾーンを指定する定期的なスケジュールされたアクションを作成する](#recurring-schedule-set-time-zone)

## 1 回だけ実行される、スケジュールされたアクションを作成する
<a name="one-time-schedule"></a>

指定した日時にスケーラブルターゲットを 1 度だけ自動的にスケーリングするには、`--schedule "at({{yyyy-mm-ddThh:mm:ss}})"` オプションを使用します。

**Example 例: 1 回限りのスケールアウト**  
以下は、特定の日時に容量をスケールアウトするためのスケジュールされたアクションを作成する例です。  
`--schedule` に指定された日時 (2021 年 3 月 31 日の午後 10:00 (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 例: 1 回限りのスケールイン**  
以下は、特定の日時に容量をスケールインするためのスケジュールされたアクションを作成する例です。  
`--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:00 (UTC) から 5 時間ごとに実行され、2021 年 1 月 31 日の午後 10:00 (UTC) に終了) で、`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 式を使用するスケジュールされたアクションの例です。

指定されたスケジュール (毎日午前 9:00 (UTC)) で、`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}}
```

## タイムゾーンを指定する 1 回限りのスケジュールされたアクションを作成する
<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:00 (ローカルタイム)) の時点で、`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:00 (ローカルタイム)) で、`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}}
```