スケーリンググループの属性 (インスタンスの最大数、インスタンスの最小数、希望インスタンス数など) を変更します。現在のスケーリンググループの属性がビジネス要件を満たさなくなった場合、スケーリンググループを再作成する代わりにこの操作を呼び出して属性を変更することで、時間とリソースを節約できます。
操作説明
操作の説明
-
次のパラメーターは変更できません。
-
RegionId
-
LoadBalancerId
説明ロードバランシングインスタンスを変更するには、 AttachLoadBalancers および DetachLoadBalancers 操作を使用します。
-
DBInstanceId
説明ApsaraDB RDS インスタンスを変更するには、 AttachDBInstances および DetachDBInstances 操作を使用します。
-
-
この操作は、スケーリンググループがアクティブな状態または非アクティブな状態の場合にのみ呼び出すことができます。
-
新しいスケーリング設定を有効にしても、以前のスケーリング設定に基づいて作成され、引き続き実行中の ECS インスタンスまたは Elastic Container Instance には影響しません。
-
MaxSize を変更し、スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の数が新しい MaxSize 値を超えた場合、Auto Scaling はインスタンス数が MaxSize 値と等しくなるまで、スケーリンググループからインスタンスを自動的に削除します。
-
MinSize を変更し、スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の数が新しい MinSize 値未満の場合、Auto Scaling はインスタンス数が MinSize 値と等しくなるまで、スケーリンググループにインスタンスを自動的に追加します。
-
スケーリンググループに DesiredCapacity が設定されており、DesiredCapacity を変更した場合、Auto Scaling はスケーリンググループ内のインスタンス数が DesiredCapacity 値と等しくなるように、ECS インスタンスまたは Elastic Container Instance を自動的に追加または削除します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:ModifyScalingGroup |
update |
*スケーリンググループ。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ScalingGroupId |
string |
必須 |
変更するスケーリンググループの ID。 |
asg-bp1ffogfdauy0jw0**** |
| ScalingGroupName |
string |
任意 |
スケーリンググループの名前。名前はリージョン内で一意である必要があります。名前の長さは 2~64 文字で、数字、大文字、小文字、漢字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。先頭は数字、文字、または漢字である必要があります。 |
スケーリンググループ**** |
| MinSize |
integer |
任意 |
スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の最小数。スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の数が 説明
|
1 |
| MaxSize |
integer |
任意 |
スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の最大数。スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の数が MaxSize の有効な値は、Auto Scaling の使用量によって異なります。クォータセンターコンソール に移動して、スケーリンググループ内のインスタンスの最大数のクォータを確認してください。 たとえば、スケーリンググループ内のインスタンスの最大数のクォータが 2000 の場合、 |
99 |
| DefaultCooldown |
integer |
任意 |
スケーリングアクティビティ (ECS インスタンスまたは Elastic Container Instance の追加または削除) の完了後のクールダウン時間。有効な値: 0~86400。単位: 秒。 クールダウン時間中、スケーリンググループは他のスケーリングアクティビティを実行しません。このパラメーターは、CloudMonitor のイベントトリガータスクによってトリガーされるスケーリングアクティビティにのみ適用されます。 |
600 |
| RemovalPolicy.1 |
string |
任意 |
スケーリンググループから ECS インスタンスを削除するための第 1 優先度のスケールインポリシー。有効な値:
説明
OldestScalingConfiguration で言及されているスケーリング設定は、スケーリング設定や起動テンプレートを含むインスタンス構成ソースを指します。CustomPolicy は第 1 優先度のスケールインポリシーとしてのみ設定できます。CustomPolicy を指定する場合は、CustomPolicyARN パラメーターも指定する必要があります。このパラメーターは Alibaba Cloud リソースネーム (ARN) を使用します。 |
OldestScalingConfiguration |
| RemovalPolicy.2 |
string |
任意 |
スケーリンググループから ECS インスタンスを削除するための第 2 優先度のスケールインポリシー。有効な値:
説明
OldestScalingConfiguration で言及されているスケーリング設定は、スケーリング設定や起動テンプレートを含むインスタンス構成ソースを指します。 |
NewestInstance |
| RemovalPolicy.3 |
string |
任意 |
スケーリンググループから ECS インスタンスを削除するための第 3 優先度のスケールインポリシー。有効な値:
説明
OldestScalingConfiguration で言及されているスケーリング設定は、スケーリング設定や起動テンプレートを含むインスタンス構成ソースを指します。 |
OldestInstance |
| ActiveScalingConfigurationId |
string |
任意 |
スケーリンググループ内のアクティブなスケーリング設定の ID。 |
asc-bp17pelvl720x5ub**** |
| HealthCheckType |
string |
任意 |
スケーリンググループのヘルスチェックモード。有効な値:
デフォルト値: ECS。 説明
インスタンスのヘルスチェックとロードバランシングのヘルスチェックの両方を有効にするには、 |
ECS |
| LaunchTemplateId |
string |
任意 |
スケーリンググループが起動設定情報を取得する起動テンプレートの ID。 |
lt-m5e3ofjr1zn1aw7**** |
| LaunchTemplateVersion |
string |
任意 |
起動テンプレートのバージョン。有効な値:
|
Default |
| OnDemandBaseCapacity |
integer |
任意 |
スケーリンググループに必要な従量課金インスタンスの最小数。有効な値: 0~1000。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが優先的に作成されます。
|
30 |
| OnDemandPercentageAboveBaseCapacity |
integer |
任意 |
従量課金インスタンスの最小数 (OnDemandBaseCapacity) を満たした後の超過インスタンスにおける従量課金インスタンスの割合。有効な値: 0~100。
|
20 |
| SpotInstanceRemedy |
boolean |
任意 |
スポットインスタンスを補充するかどうかを指定します。この機能が有効で、スケーリンググループがスポットインスタンスが回収されようとしているというシステムメッセージを受信した場合、スケーリンググループは新しいインスタンスを作成して、回収されようとしているスポットインスタンスを置き換えようとします。 |
true |
| CompensateWithOnDemand |
boolean |
任意 |
コストや在庫不足などの理由でスポットインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成するかどうかを指定します。このパラメーターは、
|
true |
| SpotInstancePools |
integer |
任意 |
利用可能なインスタンスタイプの数。スケーリンググループは、複数のタイプのスポットインスタンスを最低コストで作成します。有効な値: 0~10。
|
5 |
| DesiredCapacity |
integer |
任意 |
スケーリンググループ内の ECS インスタンスまたは Elastic Container Instance の希望数。このパラメーターを設定すると、希望インスタンス数機能が有効になります。スケーリンググループは、ECS インスタンスまたは Elastic Container Instance の数を希望数に自動的に維持します。有効な値: MinSize ≤ DesiredCapacity ≤ MaxSize。この操作の呼び出しにより希望数を管理します。 説明
希望インスタンス数機能を無効にしてから再度有効にする場合は、 |
5 |
| GroupDeletionProtection |
boolean |
任意 |
スケーリンググループの削除保護を有効にするかどうかを指定します。有効な値:
|
true |
| MultiAZPolicy |
string |
任意 |
マルチゾーン スケーリンググループ内の ECS インスタンスのスケーリングポリシー。有効な値:
|
PRIORITY |
| VSwitchIds |
array |
任意 |
1 つ以上の vSwitch の ID。 このパラメーターは、スケーリンググループのネットワークタイプが VPC の場合にのみ効果が適用されます。指定された vSwitch は、スケーリンググループと同じ VPC に属している必要があります。この操作の呼び出しにより設定します。 vSwitch は複数のゾーンにまたがるることができます。vSwitch の優先度は数値の昇順でソートされ、1 が最も高い優先度を示します。優先度の高い vSwitch のゾーンで ECS インスタンスを作成できない場合、システムは自動的に次に優先度の高い vSwitch を選択します。 |
vsw-bp1oo2a7isyrb8igf**** |
|
string |
任意 |
1 つ以上の vSwitch の ID。N の有効な値: 1~5。 このパラメーターは、スケーリンググループのネットワークタイプが VPC の場合にのみ効果が適用されます。指定された vSwitch は、スケーリンググループと同じ VPC に属している必要があります。この操作の呼び出しにより設定します。 vSwitch は複数のゾーンにまたがるることができます。vSwitch の優先度は数値の昇順でソートされ、1 が最も高い優先度を示します。優先度の高い vSwitch のゾーンで ECS インスタンスを作成できない場合、システムは自動的に次に優先度の高い vSwitch を選択します。 |
vsw-bp1oo2a7isyrb8igf**** |
|
| LaunchTemplateOverride |
array<object> |
任意 |
起動テンプレートのオーバーライド情報。 |
|
|
object |
任意 |
起動テンプレートのオーバーライド情報。 |
||
| InstanceType |
string |
任意 |
インスタンスタイプの容量に基づいてスケーリンググループをスケーリングするには、このパラメーターと LaunchTemplateOverride.N.WeightedCapacity の両方を指定します。 このパラメーターはインスタンスタイプを指定し、起動テンプレート内のインスタンスタイプをオーバーライドします。このパラメーターに N 個の値を指定して、起動テンプレートを拡張し、N 個のインスタンスタイプをサポートできます。N の有効な値: 1~20。 説明
このパラメーターは、LaunchTemplateId パラメーターで起動テンプレートが指定されている場合にのみ効果が適用されます。 InstanceType の有効な値: 購入可能な ECS インスタンスタイプ。詳細については、「インスタンスファミリー」を参照してください。 |
ecs.c5.xlarge |
| WeightedCapacity |
integer |
任意 |
インスタンスタイプの容量に基づいてスケーリンググループをスケーリングするには、LaunchTemplateOverride.N.InstanceType を指定した後にこのパラメーターを指定します。2 つのパラメーターは 1 対 1 で対応し、N の値は同じである必要があります。 このパラメーターはインスタンスタイプの重みを指定し、スケーリンググループ内のこのタイプの単一インスタンスの容量を表します。重みが大きいほど、希望容量を満たすために必要なこのタイプのインスタンス数が少なくなります。 インスタンスタイプは vCPU の数やメモリサイズなどのパフォーマンスメトリクスが異なるため、要件に基づいて異なるインスタンスタイプに異なる重みを割り当てることができます。 例:
希望容量を満たすために、スケーリンググループは 2 つの ecs.c5.xlarge インスタンスをスケールアウトします。 説明
スケールアウト時、スケーリンググループの容量は、MaxSize とインスタンスタイプの最大値の重みの合計を超えることはできません。 WeightedCapacity の有効な値: 1~500。 |
4 |
| SpotPriceLimit |
number |
任意 |
説明
このパラメーターは、 |
0.025 |
| AzBalance |
boolean |
任意 |
スケーリンググループの容量を複数のゾーンに均等に分散するかどうかを指定します。このパラメーターは、
デフォルト値: false。 |
false |
| AllocationStrategy |
string |
任意 |
スケーリンググループが容量要件を満たすために利用可能なインスタンスタイプを選択する方法を決定する容量割り当て戦略。容量割り当て戦略は、従量課金容量とスポット容量の両方に適用されます。このパラメーターは、
デフォルト値: priority (優先度)。 |
優先度 |
| SpotAllocationStrategy |
string |
任意 |
スポット容量割り当て戦略。このパラメーターを使用して、スポット容量の割り当て戦略を個別に指定できます。このパラメーターは、
デフォルト値: priority (優先度)。 |
lowestPrice |
| MaxInstanceLifetime |
integer |
任意 |
インスタンスがスケーリンググループに留まることができる最大時間。単位: 秒。 有効な値: 0 または デフォルト値: null。 説明
このパラメーターは、ECI タイプのスケーリンググループ、または節約モードが有効なスケーリンググループではサポートされていません。 |
86400 |
| CustomPolicyARN |
string |
任意 |
カスタムスケールインポリシー (関数) の Alibaba Cloud リソースネーム (ARN)。このパラメーターは、RemovalPolicies の最初のスケールインポリシーが CustomPolicy に設定されている場合にのみ効果が適用されます。 |
acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_ポリシー.LATEST/関数/ess_custom_terminate_ポリシー_name |
| DisableDesiredCapacity |
boolean |
任意 |
スケーリンググループの希望インスタンス数機能を無効にするかどうかを指定します。有効な値:
説明
このパラメーターを true に設定できるのは、スケーリンググループでスケーリングアクティビティが実行されていない場合のみです。希望インスタンス数機能が無効になると、スケーリンググループの現在の |
false |
| ScalingPolicy |
string |
任意 |
スケーリンググループの回収モード。有効な値:
ScalingPolicy はスケーリンググループの回収モードを指定します。ただし、インスタンスがスケーリンググループから削除されるときの具体的なアクションは、RemoveInstances の RemovePolicy パラメーターによって決定されます。詳細については、「 RemoveInstances 」を参照してください。 |
recycle |
| HealthCheckTypes |
array |
任意 |
スケーリンググループのヘルスチェックモード。 説明
このパラメーターに複数の値を指定して、複数のヘルスチェックオプションを有効にすることができます。 |
|
|
string |
任意 |
スケーリンググループのヘルスチェックモードのリスト。有効な値:
デフォルト値: ECS。 |
ECS |
|
| StopInstanceTimeout |
integer |
任意 |
スケールインプロセス中に ECS インスタンスが停止するのを待つタイムアウト期間。単位: 秒。有効な値: 30~240。 説明
|
60 |
| CapacityOptions |
object |
任意 |
容量オプション。 |
|
| OnDemandBaseCapacity |
integer |
任意 |
スケーリンググループに必要な従量課金インスタンスの最小数。スケーリンググループ内の従量課金インスタンスの数がこの値未満の場合、システムは従量課金インスタンスを優先的に作成します。有効な値: 0~1000。
|
30 |
| OnDemandPercentageAboveBaseCapacity |
integer |
任意 |
従量課金インスタンスの最小数 (
|
20 |
| CompensateWithOnDemand |
boolean |
任意 |
コストや在庫不足などの理由でスポットインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成するかどうかを指定します。このパラメーターは、
|
true |
| SpotAutoReplaceOnDemand |
boolean |
任意 |
デフォルト値: false。 |
true |
| PriceComparisonMode |
string |
任意 |
スケーリンググループのコスト最適化戦略の価格比較モード。有効な値:
デフォルト値: PricePerUnit。 |
PricePerUnit |
| BalanceMode |
string |
任意 |
ゾーンバランシングモード。このパラメーターは、ゾーンバランシングが有効な場合にのみ効果が適用されます。有効な値:
デフォルト値: BalancedBestEffort。 |
BalancedBestEffort |
| AutoRebalance |
boolean |
任意 |
スケーリンググループの自動リバランスを有効にするかどうかを指定します。このパラメーターは、ゾーンバランス型スケーリンググループで BalancedOnly が有効な場合にのみ効果が適用されます。この操作の呼び出しにより設定します。有効な値:
デフォルト値: false。 |
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。