スケーリンググループを有効にします。
操作説明
操作の説明
-
スケーリンググループが Inactive 状態であり、インスタンス構成ソース(スケーリング設定、起動テンプレート、またはスケーリンググループ作成時に指定された ECS インスタンス)がある場合にのみ、この操作を呼び出してスケーリンググループを有効にできます。それ以外の場合、呼び出しは失敗します。
説明スケーリンググループは一度に 1 つのアクティブなインスタンス構成ソースのみを持つことができます。この操作を呼び出す際に、スケーリンググループのスケーリング設定または起動テンプレートを指定できます。この操作を呼び出す前にスケーリンググループのインスタンス構成ソースを既にセットしている場合、スケーリング設定または起動テンプレートを指定すると既存の構成がオーバーライドされます。
-
この操作を呼び出す時に、スケーリンググループに追加する ECS インスタンス(InstanceId.N)を指定した場合、Auto Scaling は ECS インスタンスの追加後にスケーリンググループ内の ECS インスタンスの合計数(Total Capacity)が最小値(MinSize)と最大値(MaxSize)の間に収まるかどうかを確認します:
スケーリンググループの Total Capacity が MinSize 未満の場合、Auto Scaling は差分を補うために従量課金 ECS インスタンスを自動的に作成します。
例えば、スケーリンググループの作成時に MinSize を 5 にセットし、スケーリンググループの有効化時に InstanceId.N パラメーターで既存の ECS インスタンスを 2 つ指定した場合、Auto Scaling は 2 つの既存 ECS インスタンスを追加し、さらに 3 つの ECS インスタンスを自動的に作成します。
スケーリンググループの Total Capacity が MaxSize を超える場合、呼び出しは失敗します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:EnableScalingGroup |
update |
*ScalingGroup
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
スケーリンググループの ID。 |
asg-bp14wlu85wrpchm0**** |
| ActiveScalingConfigurationId |
string |
任意 |
スケーリンググループでアクティブ化するスケーリング設定の ID。 |
asc-bp1ffogfdauy0nu5**** |
| LaunchTemplateId |
string |
任意 |
起動テンプレートの ID。このパラメーターは、スケーリンググループが起動テンプレートから起動構成情報を取得することを指定します。 |
lt-m5e3ofjr1zn1aw7**** |
| LaunchTemplateVersion |
string |
任意 |
起動テンプレートのバージョン。有効な値:
|
Default |
| InstanceId |
array |
任意 |
スケーリンググループの有効化後にスケーリンググループに追加する ECS インスタンスの ID。N の有効な値: 1~20。 スケーリンググループに追加する ECS インスタンスは、次の条件を満たす必要があります:
|
i-283vv**** |
|
string |
任意 |
スケーリンググループの有効化後にスケーリンググループに追加する ECS インスタンスの ID。N の有効な値: 1~20。 スケーリンググループに追加する ECS インスタンスは、次の条件を満たす必要があります:
|
i-283vv**** |
|
| LoadBalancerWeight |
array |
任意 |
関連付けられた Server Load Balancer(SLB)インスタンスのバックエンドサーバーとしての ECS インスタンスまたは Elastic コンテナインスタンスの重み。N の有効な値: 1~20。このパラメーターの有効な値: 1~100。 デフォルト値: 50。 |
50 |
|
integer |
任意 |
関連付けられた SLB インスタンスのバックエンドサーバーとしての ECS インスタンスまたは Elastic コンテナインスタンスの重み。N の有効な値: 1~20。このパラメーターの有効な値: 1~100。 デフォルト値: 50。 |
50 |
|
| LaunchTemplateOverride |
array<object> |
任意 |
起動テンプレートのオーバーライド情報。 |
|
|
object |
任意 |
起動テンプレートのオーバーライド情報。 |
||
| InstanceType |
string |
任意 |
スケーリンググループをインスタンスタイプの容量に基づいてスケーリングする場合、このパラメーターと LaunchTemplateOverride.N.WeightedCapacity の両方を指定します。 このパラメーターは ECS インスタンスタイプを指定し、起動テンプレート内の ECS インスタンスタイプをオーバーライドします。このパラメーターに N 個の値を指定して、起動テンプレートを N 個のインスタンスタイプをサポートするように拡張できます。N の有効な値: 1~10。 説明
このパラメーターは、LaunchTemplateId パラメーターで起動テンプレートが指定されている場合にのみ効果があります。 InstanceType の有効な値については、インスタンスファミリーを参照してください。 |
ecs.c5.xlarge |
| WeightedCapacity |
integer |
任意 |
スケーリンググループをインスタンスタイプの容量に基づいてスケーリングする場合、LaunchTemplateOverride.N.InstanceType を指定した後にこのパラメーターを指定する必要があります。2 つのパラメーターは 1 対 1 で対応し、N の値は同じである必要があります。 このパラメーターはインスタンスタイプの重みを指定します。これは、スケーリンググループにおけるこのタイプの単一インスタンスの容量を表します。重みが大きいほど、期待される容量を満たすために必要なこのタイプのインスタンス数が少なくなります。 インスタンスタイプは vCPU 数、メモリサイズ、その他のパフォーマンスメトリクスが異なるため、要件に基づいて異なるインスタンスタイプに異なる重みを割り当てることができます。 例:
期待される容量を満たすために、スケーリンググループは ecs.c5.xlarge インスタンスを 2 つ追加してスケールアウトします。 説明
スケールアウト中、スケーリンググループの容量は最大容量(MaxSize)とインスタンスタイプの中の最大値の重みの合計を超えることはできません。 WeightedCapacity の有効な値: 1~500。 |
4 |
| RegionId |
string |
任意 |
スケーリンググループのリージョン ID。 |
cn-qingdao |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。