Auto Scaling:ModifyScalingGroup

変更するスケーリンググループの ID です。

スケーリンググループの名前です。各リージョン内でスケーリンググループ名は一意である必要があります。名前の長さは 2～64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を使用できます。名前は英字または数字で始める必要があります。

スケーリンググループに含める ECS インスタンスまたはエラスティックコンテナインスタンスの最小数です。スケーリンググループ内のインスタンス総数がMinSizeの値を下回る場合、Auto Scaling は最小数を満たすようにインスタンスをスケーリンググループへ追加します。

スケーリンググループに含めることができる ECS インスタンスまたはエラスティックコンテナインスタンスの最大数です。スケーリンググループ内のインスタンス総数がMaxSizeの値を上回る場合、Auto Scaling は最大数を超えないように、余剰なインスタンスをスケーリンググループから削除します。

MaxSizeの値の範囲は、ビジネスが Auto Scaling に依存する度合いと直接関係します。「クォータセンター」で、1 つのスケーリンググループに含めることができる最大インスタンス数を確認できます。

たとえば、スケーリンググループに最大 2,000 台のインスタンスを含められる場合、MaxSizeの値の範囲は 0～2000 です。

スケーリンググループのクールダウン期間です。このパラメーターは、ScalingRuleTypeをSimpleScalingRuleに設定した場合にのみ使用できます。有効な値：0～86400。単位：秒。

クールダウン期間中、Auto Scaling は CloudMonitor のイベントトリガータスクによってトリガーされたスケーリングアクティビティを実行しません。

スケーリンググループ内の有効なスケーリング設定の ID です。

スケーリンググループのヘルスチェックモードです。有効な値：

• NONE：Auto Scaling はインスタンスのヘルスステータスを確認しません。

• ECS：Auto Scaling はスケーリンググループ内のインスタンスのヘルスステータスを確認します。インスタンスのヘルスチェックを有効にする場合は、スケーリンググループが ECS タイプか Elastic Container Instance タイプかに関係なく、値をECSに設定できます。

• LOAD_BALANCER：Auto Scaling は、ロードバランサーのヘルスチェック結果に基づいて、スケーリンググループ内のインスタンスのヘルスステータスを確認します。Classic Load Balancer (CLB) インスタンスのヘルスチェック結果は、スケーリンググループ内のインスタンスのヘルスチェック基準としてサポートされません。デフォルト値：ECS。

Auto Scaling がインスタンスを作成するために使用する起動テンプレートの ID です。

起動テンプレートのバージョン番号です。有効な値：

• 固定のテンプレートバージョン番号。

• Default：デフォルトのテンプレートバージョンを常に使用します。

• Latest：最新のテンプレートバージョンを常に使用します。

スケーリンググループで維持されるべき従量課金インスタンスの最小数です。従量課金インスタンス数がこのパラメーターの値を下回った場合、Auto Scaling は従量課金インスタンスを優先的に作成します。有効な値：0～1000。

MultiAZPolicy パラメーターを COMPOSABLE に設定した場合、デフォルト値は 0 です。

OnDemandBaseCapacityで設定したインスタンス数を超えてスケールアウトする際に、追加されるインスタンスに占める従量課金インスタンスの割合 (%) です。有効な値：0～100。

MultiAZPolicy パラメーターを COMPOSABLE に設定した場合、デフォルト値は 100 です。

プリエンプティブルインスタンスを補充するかどうかを指定します。このパラメーターをtrueに設定すると、Auto Scaling がプリエンプティブルインスタンスの回収通知を受信した際に、そのインスタンスを置き換えるためのインスタンスを作成します。

コストやリソース不足の問題でプリエンプティブルインスタンスを必要数確保できない場合に、不足分を補うために従量課金インスタンスを自動作成するかどうかを指定します。このパラメーターは、MultiAZPolicy を COST_OPTIMIZED に設定した場合にのみ有効です。有効な値：

• true

• false

Auto Scaling が最も低価格なプリエンプティブルインスタンスを起動するために使用する、インスタンスタイプのプール数です。有効な値：0～10。

MultiAZPolicy パラメーターを COMPOSABLE に設定した場合、デフォルト値は 2 です。

スケーリンググループ内の ECS インスタンスまたはエラスティックコンテナインスタンスの期待インスタンス数です。Auto Scaling は、スケーリンググループ内のインスタンス数がこの目標数を維持するように動作します。このパラメーターを指定する際は、次のルールに従ってください：MaxSizeの値 ≥ DesiredCapacityの値 ≥ MinSizeの値

スケーリンググループの削除保護を有効にするかどうかを指定します。有効な値：

• true：スケーリンググループの削除保護を有効にします。この場合、スケーリンググループを削除できません。

• false：スケーリンググループの削除保護を無効にします。

ECS インスタンスを含むマルチゾーンスケーリンググループのスケーリングポリシーです。有効な値：

• PRIORITY：ECS インスタンスは vSwitch の優先度に基づいてスケーリングされます。VSwitchIdsパラメーターで指定した最初の vSwitch の優先度が最も高くなります。Auto Scaling は、優先度が最も高い vSwitch が属するゾーンでインスタンスを優先的にスケーリングします。スケーリングに失敗した場合、Auto Scaling は次に優先度が高い vSwitch が属するゾーンでインスタンスをスケーリングします。

• COST_OPTIMIZED：スケールアウト時、Auto Scaling は vCPU あたりの単価が最も安いインスタンスタイプの ECS インスタンスを優先的に作成します。スケールイン時、Auto Scaling は vCPU あたりの単価が最も高いインスタンスタイプの ECS インスタンスを優先的に削除します。スケーリング設定でプリエンプティブルインスタンスのインスタンスタイプを指定した場合、Auto Scaling はプリエンプティブルインスタンスを優先的に作成します。CompensateWithOnDemand パラメーターを使用して、Auto Scaling がプリエンプティブルインスタンスを作成できなかった場合に従量課金インスタンスを自動的に作成するかどうかを指定できます。

• BALANCE：ECS インスタンスは、スケーリンググループで指定したゾーンに均等に分散されます。リソース不足によりゾーン間で ECS インスタンスの分散が不均一になった場合は、RebalanceInstance API を呼び出して、ゾーン間でインスタンスを均等に分散できます。

• COMPOSABLE：ビジネス要件に基づいて、前述のポリシーを柔軟に組み合わせることができます。

スケーリンググループ内のインスタンスの最大存続期間です。単位：秒。

有効な値：86400～Integer.maxValue。このパラメーターは 0 に設定することもできます。値 0 は、スケーリンググループ内でインスタンスの存続期間が無制限であることを示します。

デフォルト値：null。

スケーリンググループ内のインスタンスをゾーン間で均等に分散するかどうかを指定します。このパラメーターは、MultiAZPolicy を COMPOSABLE に設定した場合にのみ有効です。有効な値：

• true

• false

デフォルト値：false。

割り当てポリシーです。Auto Scaling は割り当てポリシーに基づいてインスタンスタイプを選択し、必要な数のインスタンスを作成します。このポリシーは、従量課金インスタンスとプリエンプティブルインスタンスの両方に同時に適用できます。このパラメーターは、MultiAZPolicy を COMPOSABLE に設定した場合にのみ有効です。有効な値：

• priority：Auto Scaling は指定した順序に基づいてインスタンスタイプを選択し、必要な数のインスタンスを作成します。

• lowestPrice：Auto Scaling は vCPU あたりの単価が最も安いインスタンスタイプを選択し、必要な数のインスタンスを作成します。

デフォルト値：priority。

プリエンプティブルインスタンスの割り当てポリシーです。このパラメーターを使用して、プリエンプティブルインスタンスの割り当てポリシーを個別に指定できます。このパラメーターは、MultiAZPolicy を COMPOSABLE に設定した場合にのみ有効です。有効な値：

• priority：Auto Scaling は指定した順序に基づいてインスタンスタイプを選択し、必要な数のプリエンプティブルインスタンスを作成します。

• lowestPrice：Auto Scaling は vCPU あたりの単価が最も安いインスタンスタイプを選択し、必要な数のプリエンプティブルインスタンスを作成します。

デフォルト値：priority。

カスタムスケーリングポリシー (Function) の ARN です。このパラメーターは、インスタンス削除ポリシーの最初のステップとしてCustomPolicyを指定した場合にのみ有効です。

スケーリンググループの期待インスタンス数機能を無効にするかどうかを指定します。有効な値：

• false：期待インスタンス数機能を有効にします。

• true：期待インスタンス数機能を無効にします。

スケーリンググループの回収モードです。有効な値：

• recycle：エコノミーモード

• release：リリースモード

• forcerelease：強制リリースモード

  注 値を forcerelease に設定すると、スケールイン時に Auto Scaling は Running 状態のインスタンスを強制的にリリースします。強制リリースは停電と同等です。インスタンスが強制的にリリースされると、インスタンス上の一時データは消去され、復元できません。このオプションを選択する場合は注意してください。

  注意 値を forcerelease に設定すると、Auto Scaling はスケールイン中に Running 状態のインスタンスを強制的に解放します。 強制解放は停電に相当します。 インスタンスが強制的に解放されると、インスタンス上のエフェメラルデータは消去され、復旧できなくなります。 このオプションを選択する際は、ご注意ください。

• forcerecycle：強制回収モード

  注 値を forcerecycle に設定すると、スケールイン時に Auto Scaling は Running 状態のインスタンスを強制的にシャットダウンします。強制シャットダウンは停電と同等です。インスタンスが強制的にシャットダウンされると、インスタンス上の一時データは消去され、復元できません。このオプションを選択する場合は注意してください。

  注意 値を forcerecycle に設定した場合、Auto Scaling はスケールイン時に Running 状態のインスタンスを強制的にシャットダウンします。強制シャットダウンは停電と同等です。インスタンスが強制的にシャットダウンされると、インスタンス上のエフェメラルデータは消去され、復旧できなくなります。このオプションを選択する際はご注意ください。

ScalingPolicyは、スケーリンググループの回収モードのみを指定します。RemoveInstances API のRemovePolicyは、スケーリンググループからインスタンスを削除する方法を指定します。詳細については、「RemoveInstances」をご参照ください。

スケールイン処理において、Elastic Compute Service (ECS) インスタンスが停止状態に移行するまでのタイムアウト時間 (秒) です。有効な値：30～240。

• このパラメーターは、ScalingPolicyをreleaseに設定した場合にのみ有効です。
  このパラメーターを指定した場合、システムはStopInstanceTimeoutで指定した時間が経過するとスケールイン処理を進めます。この場合、ECS インスタンスが停止状態になったかどうかに関係なく、スケールイン処理は続行されます。
  このパラメーターを指定しない場合、システムは ECS インスタンスが停止状態になった後にスケールイン処理を進めます。ECS インスタンスが停止状態にならなかった場合、スケールイン処理はロールバックされ、スケールインは失敗と見なされます。
  
  

• ModifyScalingGroup API を呼び出す際に、この値を 0 に設定できます。この場合、システムはこのパラメーターを無視します。

ゾーンバランシングモードです。このモードは、ゾーンバランシングが有効な場合にのみ適用されます。有効な値：

• BalancedBestEffort：ゾーンでリソースの作成に失敗した場合、別のゾーンにフォールバックします。これにより、可能な限りリソースを確保します。

• BalancedOnly：ゾーンでリソースの作成に失敗した場合、別のゾーンにフォールバックしません。ゾーン間のリソースの過度な不均衡を回避するため、スケールアウトは部分的に成功します。

デフォルト値：BalancedBestEffort。

スケーリンググループの自動リバランシングを有効にするかどうかを指定します。このパラメーターは、スケーリンググループでBalancedOnlyが有効な場合にのみ適用されます。有効な値：

• false：スケーリンググループの自動リバランシングは無効です。

• true：自動リバランシングを有効にすると、スケーリンググループはゾーンのキャパシティを自動的に検出します。ゾーンのキャパシティが不均衡な場合、スケーリンググループは不足しているゾーンでのスケールアウトを試み、ゾーン間のキャパシティの再分散を行います。

デフォルト値：false。