Auto Scaling:CreateScalingGroup

スケーリンググループの名前。名前はリージョン内で一意である必要があります。

名前は 2～64 文字で、英数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。先頭は数字、英字、または漢字である必要があります。

デフォルト値：ScalingGroupId の値。

スケーリンググループが起動構成情報を取得する起動テンプレートの ID。

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

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

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

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

インスタンスの ID。スケーリンググループの作成時、指定されたインスタンスから必須の構成情報が取得され、スケーリング設定が自動作成の対象となります。

スケーリンググループのリージョン ID。

スケーリンググループ内のインスタンスの最小値。スケーリンググループ内のインスタンス数が MinSize 値未満の場合、Auto Scaling はインスタンスの自動作成を実行します。

スケーリンググループ内のインスタンスの最大値。スケーリンググループ内のインスタンス数が MaxSize 値を超えた場合、Auto Scaling は自動的にインスタンスを削除します。

MaxSize の有効な値は、Auto Scaling の使用量によって異なります。単一スケーリンググループ内のインスタンスの最大値のクォータを確認するには、クォータセンター に移動してください。

単一スケーリンググループ内のインスタンスの最大値のクォータが 2000 の場合、MaxSize の有効な値は 0～2000 です。

スケーリングアクティビティ（インスタンスの追加または削除）完了後のクールダウン時間。有効な値：0～86400。単位：秒。

クールダウン時間中、スケーリンググループは他のスケーリングアクティビティを実行しません。これは CloudMonitor のイベントトリガータスクによってトリガーされたスケーリングアクティビティにのみ適用されます。

デフォルト値：300。

CLB インスタンスの ID。値は複数の CLB インスタンス ID で構成される JSON 配列にすることができます。複数の ID はコンマ (,) で区切ります。

単一スケーリンググループに関連付けられる CLB インスタンスの総数は、Auto Scaling の使用量によって異なります。単一スケーリンググループに関連付けられる負荷分散インスタンスの総数のクォータを確認するには、クォータセンター に移動してください。

ApsaraDB RDS インスタンスの ID。値は複数の RDS インスタンス ID で構成される JSON 配列にすることができます。複数の ID はコンマ (,) で区切ります。

単一スケーリンググループに関連付けられる RDS インスタンスの総数は、Auto Scaling の使用量によって異なります。単一スケーリンググループに関連付けられる RDS インスタンスの総数のクォータを確認するには、クォータセンター に移動してください。

vSwitch の ID。このパラメーターを指定すると、スケーリンググループのネットワークタイプは VPC になります。

マルチゾーンスケーリンググループ内の ECS インスタンスのスケーリングポリシー。有効な値：

• PRIORITY：最初に指定された vSwitch (VSwitchIds) が最高の優先度を持ちます。Auto Scaling は、優先度が最も高い vSwitch のゾーンでインスタンスのスケーリングを優先的に試行します。スケーリングに失敗した場合、Auto Scaling は自動的に次の優先度の vSwitch のゾーンでインスタンスのスケーリングを試行します。

• COST_OPTIMIZED：スケールアウト時、Auto Scaling は vCPU の単位価格の昇順で ECS インスタンスの作成を試行します。スケールイン時、Auto Scaling は vCPU の単位価格の降順で ECS インスタンスの削除を試行します。スケーリング設定がプリエンプティブル課金方法を持つ複数のインスタンスタイプを指定している場合、スポットインスタンスが優先的に作成されます。CompensateWithOnDemand パラメーターを使用して、在庫不足などの理由でスポットインスタンスを作成できない場合に、従量課金インスタンスを自動的に作成するかどうかを指定できます。

  説明

  COST_OPTIMIZED は、スケーリング設定が複数のインスタンスタイプを指定しているか、スポットインスタンスを使用している場合にのみ有効になります。

• BALANCE：ECS インスタンスは、スケーリンググループに指定された複数のゾーンに均等に分散されます。在庫不足などの理由でゾーンのバランスが崩れた場合、 RebalanceInstance を呼び出してリソースをリバランスできます。

  説明

  MultiAZPolicy が BALANCE に設定されている場合の効果は、MultiAZPolicy が COMPOSABLE に設定され、AzBalance が true に設定されている場合と同じです。

• COMPOSABLE：上記のマルチゾーンスケーリングポリシーの組み合わせをカスタマイズできる複合ポリシーです。追加のパラメーターを指定して、スケーリンググループの容量をよりきめ細かくコントロールすることもできます。

デフォルト値：PRIORITY。

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

• NONE：ヘルスチェックは実行されません。

• ECS：スケーリンググループ内のインスタンスに対してヘルスチェックを実行します（ECS タイプと ECI タイプの両方のスケーリンググループで、この値を使用してインスタンスのヘルスチェックを有効にします）。

• LOAD_BALANCER：ロードバランサーのヘルスチェック結果に基づいてインスタンスのヘルスステータスを判定します（CLB ロードバランサータイプはサポートされていません）。

デフォルト値：ECS。

スケーリンググループの取り消すモードを指定します。有効な値：

• recycle：スケーリンググループはシャットダウンおよび回収モードを使用します。

• release：スケーリンググループはリリースモードを使用します。

• forcerelease：スケーリンググループは強制リリースモードを使用します。
  説明

  forcerelease を選択した場合、スケールダウンアクティビティ中に Running 状態のインスタンスが強制的にリリースされます。インスタンスの強制リリースは電源オフ操作と同等であり、インスタンスのメモリおよびストレージ内の一時データが消去されます。データは復元できません。慎重に操作してください。

• forcerecycle：スケーリンググループは強制シャットダウンおよび回収モードを使用します。
  説明

  forcerecycle を選択した場合、スケールダウンアクティビティ中に Running 状態のインスタンスが強制的にシャットダウンされます。インスタンスの強制シャットダウンは電源オフ操作と同等であり、インスタンスのメモリおよびストレージ内の一時データが消去されます。データは復元できません。慎重に操作してください。

ScalingPolicy はスケーリンググループの取り消すモードを指定しますが、インスタンスがスケーリンググループから削除される際の具体的なアクションは、RemoveInstances の RemovePolicy パラメーターによって決定されます。詳細については、「 RemoveInstances 」をご参照ください。

リクエストのべき等性を確保します。

クライアント側で生成するパラメーター値で、異なるリクエスト間で一意である必要があります。値には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保方法」をご参照ください。

スケーリンググループに必要な従量課金インスタンスの最小値。有効な値：0～1000。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが優先的に作成されます。

従量課金インスタンスの最小値（OnDemandBaseCapacity）を満たした後の超過インスタンスのうち、従量課金インスタンスが占める割合。有効な値：0～100。

補充スポットインスタンスポリシーを有効にするかどうかを指定します。このポリシーを有効にすると、Auto Scaling グループがスポットインスタンスの回収予定を示すシステムメッセージを受信した際に、回収予定のスポットインスタンスを置き換える新しいインスタンスの作成を試行します。

価格、在庫、またはその他の理由でスポットインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成するかどうかを指定します。このパラメーターは MultiAZPolicy が COST_OPTIMIZED に設定されている場合にのみ効果があります。有効な値：

• true：自動作成を許可します。

• false：自動作成を許可しません。

デフォルト値：true。

利用可能なインスタンスタイプの数。スケーリンググループは、複数のインスタンスタイプにわたって最低コストでバランスよくスポットインスタンスを作成します。有効な値：1～10。

スケーリンググループ内の予想インスタンス数。スケーリンググループは、インスタンス数を自動的に予想数に維持します。値は MaxSize より大きくなく、MinSize より小さくない必要があります。

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

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

• false：削除保護を無効にします。

デフォルト値：false。

スケーリンググループが管理するインスタンスのタイプ。有効な値：

• ECS：スケーリンググループは ECS インスタンスを管理します。

• ECI：スケーリンググループは ECI インスタンスを管理します。

デフォルト値：ECS。

ECI インスタンスの ID。コンテナグループの ID です。

スケーリンググループの容量が複数のゾーンに均等に分散されるかどうかを指定します。このパラメーターは MultiAZPolicy が COMPOSABLE に設定されている場合にのみ有効になります。有効な値：

• true：スケーリンググループの容量は複数のゾーンに均等に分散されます。

• false：スケーリンググループの容量は複数のゾーンに均等に分散されません。

デフォルト値：false。

容量要件を満たすためにスケーリンググループが利用可能なインスタンスタイプを選択する方法を決定する容量割り当て戦略。容量割り当て戦略は、従量課金容量とスポット容量の両方に適用されます。このパラメーターは MultiAZPolicy が COMPOSABLE に設定されている場合にのみ有効になります。有効な値：

• priority：設定されたインスタンスタイプの順序でインスタンスを作成します。

• lowestPrice：vCPU の単位価格の昇順でインスタンスを作成します。

デフォルト値：priority。

スポット容量の割り当て戦略。このパラメーターを使用して、スポット容量の割り当て戦略を個別に指定できます。このパラメーターは MultiAZPolicy が COMPOSABLE に設定されている場合にのみ有効になります。有効な値：

• priority：設定されたインスタンスタイプの順序でインスタンスを作成します。

• lowestPrice：vCPU の単位価格の昇順でインスタンスを作成します。

デフォルト値：priority。

インスタンスがスケーリンググループ内に存在できる最大時間。単位：秒。

有効な値：[86400, Integer.maxValue]。

デフォルト値：null。

カスタムスケールインポリシー（関数）の Amazon リソースネーム (ARN)。このパラメーターは、RemovalPolicies の最初のスケールインポリシーが CustomPolicy に設定されている場合にのみ効果があります。

新しく作成されたスケーリンググループが属するリソースグループの ID。

スケールインプロセス中に ECS インスタンスが停止するのを待機するタイムアウト時間。単位：秒。 有効な値：30～240。

ゾーンバランシングモード。このパラメーターはゾーンバランシングが有効な場合にのみ効果があります。有効な値：

• BalancedBestEffort：あるゾーンでのリソース作成に失敗した場合、システムはベストエフォートでのリソース提供を確保するために他のゾーンにフォールバックします。

• BalancedOnly：あるゾーンでのリソース作成に失敗した場合、システムは他のゾーンにフォールバックしません。ゾーン間のリソースの過度な不均衡を防ぐため、スケーリングアクティビティは部分的に成功となります。

デフォルト値：BalancedBestEffort。

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

• false：自動リバランスは無効です。

• true：自動リバランスが有効な場合、スケーリンググループはゾーン全体の容量を自動的に監視します。ゾーン間で容量の不均衡が生じた場合、システムはプロアクティブにスケールアウトおよびスケールイン操作を実行して容量をリバランスします。

デフォルト値：false。