すべてのプロダクト
Search
ドキュメントセンター

Auto Scaling:CreateScalingGroup

最終更新日:Sep 17, 2026

指定されたタイプのインスタンス数を自動的に増減する呼び出しが必要な場合に、ビジネスの変化とポリシーに基づいて計算容量 (インスタンス数) を自動的に調整するためのスケーリンググループを作成します。

操作説明

スケーリンググループは、同じ共通シナリオに対応する ECS インスタンスのコレクションです。

1 つのリージョンで作成できるスケーリンググループの数は、Auto Scaling の使用量によって異なります。スケーリンググループの総数のクォータ値を表示するには、クォータセンターに移動してください。

スケーリンググループは、作成直後には効果を持ちません。スケーリングアクティビティをトリガーしてスケーリングルールを実行する前に、 EnableScalingGroup 操作を呼び出し、スケーリンググループを有効にする必要があります。

スケーリンググループ、関連付けられた Classic Load Balancer (CLB、旧 SLB) インスタンス、および関連付けられた ApsaraDB RDS インスタンスは、同じリージョンにある必要があります。詳細については、「リージョンとゾーン」のフォーマットを参照してください。

CLB インスタンスをスケーリンググループに関連付けると、スケーリンググループは、スケーリンググループに参加する ECS インスタンスを CLB インスタンスのバックエンドサーバーグループに自動的に追加する呼び出しを行います。ECS インスタンスを追加するサーバーグループを指定できます。次の 2 種類のサーバーグループがサポートされています。

  • デフォルトサーバーグループ: フロントエンドリクエストを受け入れるために使用されます。リスナーに仮想サーバーグループまたはプライマリ/セカンダリサーバーグループが設定されていない場合、リクエストはデフォルトでデフォルトサーバーグループ内の ECS インスタンスに転送されます。

  • 仮想サービスグループ: 異なるリクエストを異なるバックエンドサーバーに転送する場合、またはドメイン名や URL に基づいてリクエストを転送する場合に、仮想サービスグループを使用します。

説明

デフォルトサーバーグループと複数の仮想サービスグループの両方を指定した場合、ECS インスタンスはこれらすべてのサーバーグループに追加されます。

インスタンスが CLB インスタンスのバックエンドサーバーグループに追加された後、そのインスタンスの重みはデフォルトで 50 に設定されます。CLB インスタンスは次の条件を満たす必要があります。

  • CLB インスタンスがアクティブな状態である必要があります。 DescribeLoadBalancers 操作を呼び出して、指定された CLB インスタンスのステータスをクエリできます。

  • CLB インスタンスに設定されているすべてのリスナーポートでヘルスチェックが有効になっている必要があります。そうでない場合、スケーリンググループの作成に失敗します。

Application Load Balancer (ALB) サーバーグループ、Network Load Balancer (NLB) サーバーグループ、または Gateway Load Balancer (GWLB) サーバーグループをスケーリンググループに関連付けると、スケーリンググループは、スケーリンググループに参加する ECS インスタンスを ALB、NLB、または GWLB サーバーグループのバックエンドサーバーとして自動的に追加し、ALB、NLB、または GWLB インスタンスによって分散されたアクセスリクエストを処理する呼び出しを行います。複数の ALB、NLB、または GWLB サーバーグループを指定できますが、サーバーグループはスケーリンググループと同じ VPC に属している必要があります。詳細については、「 AttachAlbServerGroups 」または「 AttachServerGroups 」のフォーマットを参照してください。

ApsaraDB RDS インスタンスをスケーリンググループに関連付ける呼び出しを行うと、スケーリンググループは、スケーリンググループに参加する ECS インスタンスの内部 IP アドレスを ApsaraDB RDS インスタンスのホワイトリストに自動的に追加します。ApsaraDB RDS インスタンスは次の条件を満たす必要があります。

  • ApsaraDB RDS インスタンスが実行中状態である必要があります。 DescribeDBInstances 操作を呼び出して、指定された ApsaraDB RDS インスタンスのステータスをクエリできます。

  • ApsaraDB RDS インスタンスのホワイトリスト内の IP アドレス数が上限を超えないようにする必要があります。詳細については、ApsaraDB RDS ドキュメントの「ホワイトリストの設定」のフォーマットを参照してください。

スケーリンググループの MultiAZPolicy が COST_OPTIMIZED に設定されている場合:

  • OnDemandBaseCapacity、OnDemandPercentageAboveBaseCapacity、および SpotInstancePools パラメーターを指定すると、コスト最適化ポリシーに基づくインスタンスの割り当てメソッドが指定され、スケールアウトおよびスケールインイベント時にこの割り当てメソッドが優先されます。タグも関連付けられます。

  • OnDemandBaseCapacity、OnDemandPercentageAboveBaseCapacity、または SpotInstancePools パラメーターを指定しない場合、コスト最適化ポリシーは最もコスト効率の高い方法でのみインスタンスを作成します。(このモードでは、エラスティシティ保証または容量予約を使用してインスタンスを作成することはできません。セカンダリネットワークインターフェースコントローラー (NIC) の vSwitch パラメーターはサポートされていません。) タグ、効果、およびコントロールの詳細については関連ドキュメントを参照してください。

スケーリンググループに伝播可能なタグを設定した場合、つまり Tags.Propagate が true に設定されている場合:

  • スケーリンググループのタグは、新しく作成されたインスタンスにのみ伝播され、スケーリンググループ内で既に実行中のインスタンスには伝播されません。

  • スケーリング設定でインスタンスタグを指定し、スケーリンググループのタグをインスタンスに伝播することを選択した場合、すべてのタグが共存します。

  • スケーリンググループの伝播可能なタグとスケーリング設定のタグが同じタグキーを持つ場合、スケーリング設定のタグ値が優先されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ess:CreateScalingGroup

create

*スケーリンググループ。

acs:ess:{#regionId}:{#accountId}:scalinggroup/*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingGroupName

string

任意

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

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

デフォルト値: ScalingGroupId の値。

スケーリンググループ****

LaunchTemplateId

string

任意

スケーリンググループが起動構成情報を取得する起動テンプレートの ID。フォーマットの詳細はドキュメントを参照してください。

lt-m5e3ofjr1zn1aw7****

LaunchTemplateVersion

string

任意

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

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

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

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

Default

InstanceId

string

任意

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

i-28wt4****

RegionId

string

必須

スケーリンググループのリージョン ID。フォーマットの詳細については、「リージョンとゾーン」を参照してください。

cn-qingdao

MinSize

integer

必須

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

説明

MinSize の値は MaxSize の値以下である必要があります。

2

MaxSize

integer

必須

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

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

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

20

DefaultCooldown

integer

任意

スケーリングアクティビティ (インスタンスの追加または削除) が完了した後のクールダウン時間。有効な値: 0~86400。単位: 秒。

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

デフォルト値: 300。

300

LoadBalancerIds

string

任意

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

1 つのスケーリンググループに関連付けられる CLB インスタンスの総数は、Auto Scaling の使用量によって異なります。スケーリンググループに関連付けられるロードバランサーインスタンスの総数のクォータ値をビューするには、クォータセンターコンソール に移動してください。

["lb-bp1u7etiogg38yvwz****", "lb-bp168cqrux9ai9l7f****", "lb-bp1jv3m9zvj22ufxp****"]

DBInstanceIds

string

任意

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

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

["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]

RemovalPolicy.1

string

任意

スケールインポリシーの第 1 四捨五入のフィルターストラテジー。このパラメーターは、RemovalPolicy.2 または RemovalPolicy.3 と同じ値にセットすることはできません。有効な値:

  • OldestInstance: スケーリンググループに最も早く追加された ECS インスタンスを削除します。

  • NewestInstance: スケーリンググループに最も最近追加された ECS インスタンスを削除します。

  • OldestScalingConfiguration: 最も古いスケーリング設定から作成された ECS インスタンスを削除します。

  • CustomPolicy: カスタムスケールインポリシー (Function) に基づいて ECS インスタンスを削除します。

OldestScalingConfiguration で言及されているスケーリング設定は、スケーリンググループ内のインスタンス構成ソース (スケーリング設定や起動テンプレートを含む) を指します。CustomPolicy は、第 1 四捨五入のスケールインポリシーとしてのみセットできます。CustomPolicy を指定する場合は、CustomPolicyAmazon リソースネーム (ARN) パラメーターも指定する必要があります。フォーマットに従ってください。

説明

スケーリンググループからの ECS インスタンスの削除は、スケーリンググループのスケーリングポリシー (MultiAZPolicy) の影響も受けます。詳細については、「インスタンス削除のための組み合わせポリシーの設定」を参照してください。

OldestScalingConfiguration

RemovalPolicy.2

string

任意

スケールインポリシーの第 2 ラウンドのフィルターストラテジー。このパラメーターには、RemovalPolicy.1 または RemovalPolicy.3 と同じ値を指定できません。有効な値:

  • OldestInstance: スケーリンググループに最も早く追加された ECS インスタンスを削除します。

  • NewestInstance: スケーリンググループに最も最近追加された ECS インスタンスを削除します。

  • OldestScalingConfiguration: 最も古いスケーリング設定から作成された ECS インスタンスを削除します。

説明

スケーリンググループからの ECS インスタンスの削除は、スケーリンググループのスケーリングポリシー (MultiAZPolicy) によっても影響を受けます。詳細については、「インスタンス削除の組み合わせポリシーの設定」を参照してください。

OldestInstance

RemovalPolicy.3

string

任意

スケールインポリシーの第 3 ラウンドのフィルターストラテジー。このパラメーターには、RemovalPolicy.1 または RemovalPolicy.2 と同じ値を指定できません。有効な値:

  • OldestInstance: スケーリンググループに最も早く追加された ECS インスタンスを削除します。

  • NewestInstance: スケーリンググループに最も最近追加された ECS インスタンスを削除します。

  • OldestScalingConfiguration: 最も古いスケーリング設定から作成された ECS インスタンスを削除します。

説明

スケーリンググループからの ECS インスタンスの削除は、スケーリンググループのスケーリングポリシー (MultiAZPolicy) の影響も受けます。詳細については、「インスタンス削除の組み合わせポリシーの設定」を参照してください。

NewestInstance

VSwitchId

string

任意

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

説明

スケーリンググループに VSwitchId と VSwitchIds.N のどちらも指定されていない場合、スケーリンググループのネットワークタイプはデフォルトでクラシックネットワークになります。

vsw-bp14zolna43z266bq****

MultiAZPolicy

string

任意

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

  • PRIORITY: 最初に指定された vSwitch (VSwitchIds.N) の優先度が最も高くなります。Auto Scaling は、優先度が最も高い vSwitch のゾーンでインスタンスのスケーリングを優先的に試みます。スケーリングを完了できない場合、Auto Scaling は自動的に次の優先度の vSwitch のゾーンでインスタンスのスケーリングを試みます。

  • COST_OPTIMIZED: スケールアウトイベント時、Auto Scaling は vCPU の単位価格が低い順の注文で ECS インスタンスを作成しようとします。スケールインイベント時、Auto Scaling は vCPU の単位価格が高い順の注文で ECS インスタンスを削除しようとします。スケーリング設定で複数のインスタンスタイプを持つ従量課金メソッドが指定されている場合、スポットインスタンスが優先的に作成されます。CompensateWithOnDemand パラメーターを使用して、在庫不足などの理由でスポットインスタンスを作成できない場合に、従量課金インスタンスを自動的に作成するかどうかを指定できます。

    説明

    COST_OPTIMIZED は、スケーリング設定で複数のインスタンスタイプが指定されているか、スポットインスタンスが使用されている場合にのみ効果を持ちます。

  • BALANCE: ECS インスタンスは、スケーリンググループに指定された複数のゾーンに均等に割り当てられます。在庫不足などの理由でゾーン間でインスタンスのバランスが崩れた場合、 RebalanceInstance 操作を呼び出してリソースのバランスを再調整できます。

  • COMPOSABLE: 前述のマルチゾーン スケーリングポリシーを ECS インスタンス用に組み合わせることができるコンポーザブルポリシーです。追加のパラメーターを指定して、スケーリンググループの容量をよりきめ細かくコントロールすることもできます。

デフォルト値: PRIORITY。

PRIORITY

HealthCheckType

string

任意

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

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

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

  • LOAD_BALANCER: ロードバランサーのヘルスチェック結果に基づいてインスタンスのヘルスステータスが判断されます。(CLB タイプのロードバランサーはサポートされていません。)

デフォルト値: ECS。

説明

インスタンスのヘルスチェックとロードバランサーのヘルスチェックの両方を有効にするには、HealthCheckTypes パラメーターを使用します。

ECS

ScalingPolicy

string

任意

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

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

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

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

    説明

    forcerelease を選択した場合、実行中のインスタンスはスケールインアクティビティ中に強制的にリリースされます。強制リリースは仕事率オフ操作と同等であり、インスタンスのメモリとストレージ内の一時データが消去されます。データは復元できません。慎重に操作してください。フォーマットに従ってください。

  • forcerecycle: スケーリンググループは強制シャットダウンして回収モードを使用します。

    説明

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

ScalingPolicy はスケーリンググループの回収モードを指定します。ただし、インスタンスがスケーリンググループから削除されるときに実行される具体的な操作は、RemoveInstances の RemovePolicy パラメーターによって決定されます。詳細については、「 RemoveInstances 」を参照してください。

recycle

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。

異なるリクエスト間で一意となる値をクライアントから生成します。値には ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。フォーマットの詳細については、「べき等性の確保方法」を参照してください。

123e4567-e89b-12d3-a456-42665544****

OnDemandBaseCapacity

integer

任意

スケーリンググループに必須の従量課金インスタンスの最小値。有効な値: 0~1000。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが優先的に作成されるようにセットされます。

MultiAZPolicy パラメーターが COMPOSABLE にセットされている場合、デフォルト値は 0 です。

30

OnDemandPercentageAboveBaseCapacity

integer

任意

従量課金インスタンスの最小値 (OnDemandBaseCapacity) を満たした後の超過インスタンスにおける従量課金インスタンスの割合。タグとして機能します。有効な値: 0~100。

MultiAZPolicy パラメーターが COMPOSABLE にセットされている場合、デフォルト値は 100 です。

20

SpotInstanceRemedy

boolean

任意

スポットインスタンスを補充するかどうかを指定します。この特徴が有効になっている場合、システムからスポットインスタンスが回収されようとしているという通知が送信されると、Auto Scaling は新しいインスタンスを作成してスポットインスタンスを置き換えようとします。

true

CompensateWithOnDemand

boolean

任意

価格や在庫の理由でスポットインスタンスを作成できない場合に、必須の ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成する呼び出しを行うかどうかを指定します。このパラメーターは、MultiAZPolicyCOST_OPTIMIZED にセットされている場合にのみ効果を持ちます。有効な値:

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

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

デフォルト値: true。

true

SpotInstancePools

integer

任意

利用可能なインスタンスタイプの数。Auto Scaling は、最もコストの低い複数のタイプのスポットインスタンスを均等に作成します。有効な値: 1~10。

MultiAZPolicy パラメーターが COMPOSABLE に設定されている場合、デフォルト値は 2 です。

5

DesiredCapacity

integer

任意

スケーリンググループ内の予想インスタンス数。スケーリンググループは、ECS インスタンスの数を予想インスタンス数に自動的に維持する呼び出しを行います。値は MaxSize より大きくしたり、MinSize より小さくしたりすることはできません。

5

GroupDeletionProtection

boolean

任意

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

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

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

デフォルト値: false。

true

GroupType

string

任意

スケーリンググループによって管理されるインスタンスのタイプ。有効な値:

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

  • ECI: スケーリンググループは Elastic Container Instance (ECI) インスタンスを管理します。

デフォルト値: ECS。

ECS

ContainerGroupId

string

任意

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

eci-uf6fonnghi50u374****

VSwitchIds

array

任意

1 つ以上の vSwitch の ID。VSwitchIds パラメーターを指定すると、VSwitchId パラメーターは無視されます。このパラメーターを指定すると、スケーリンググループのネットワークタイプは VPC になります。

複数の vSwitch を指定する場合:

  • vSwitch は同じ VPC に属している必要があります。

  • vSwitch は異なるゾーンに属することができます。

  • vSwitch の優先度は数値の昇順の注文で決定され、1 が最も高い優先度を示します。優先度の高い vSwitch のゾーンで ECS インスタンスを作成する呼び出しができない場合、次の優先度の vSwitch が自動的に選択されます。

説明

スケーリンググループに VSwitchId と VSwitchIds のどちらも指定されていない場合、スケーリンググループのネットワークタイプはデフォルトでクラシックネットワークになります。

vsw-bp14zolna43z266bq****

string

任意

1 つ以上の vSwitch の ID。VSwitchIds.N パラメーターを指定すると、VSwitchId パラメーターは無視されます。このパラメーターを指定すると、スケーリンググループのネットワークタイプは VPC になります。

複数の vSwitch を指定する場合:

  • vSwitch は同じ VPC に属している必要があります。

  • vSwitch は異なるゾーンに属することができます。

  • vSwitch の優先度は数値の昇順の注文で決定され、1 が最も高い優先度を示します。優先度の高い vSwitch のゾーンで ECS インスタンスを作成する呼び出しができない場合、次の優先度の vSwitch が自動的に選択されます。

説明

スケーリンググループに VSwitchId と VSwitchIds.N のどちらも指定されていない場合、スケーリンググループのネットワークタイプはデフォルトでクラシックネットワークになります。

vsw-bp14zolna43z266bq****

LifecycleHook

array<object>

任意

ライフサイクルフック情報。フォーマットに従ってください。

object

任意

ライフサイクルフック情報。フォーマットに従ってください。

DefaultResult

string

任意

待機状態が終了した後に実行する操作。有効な値:

  • CONTINUE: スケールアウトまたはスケールインイベントへの応答を続行します。

  • ABANDON: スケールアウトイベント中に作成された ECS インスタンスをリリースするか、スケールインイベント中に ECS インスタンスをスケーリンググループから直接削除します。

スケーリンググループでスケールインイベント (SCALE_IN) が発生し、複数のライフサイクルフックがトリガーされた場合、DefaultResult が ABANDON にセットされたライフサイクルフックの待機状態が終了すると、他の対応するライフサイクルフックの待機状態も早期に終了します。それ以外の場合、操作は待機状態が終了する最後のライフサイクルフックによって決定されます。

デフォルト値: CONTINUE。

CONTINUE

LifecycleHookName

string

任意

ライフサイクルフックの名前。名前が指定された後は変更済みにはできません。指定しない場合、名前はデフォルトでライフサイクルフック ID になります。

ライフサイクルフック****

LifecycleTransition

string

任意

ライフサイクルフックが適用されるスケーリングアクティビティのタイプ。有効な値:

  • SCALE_OUT: スケーリンググループのスケールアウトイベント。

  • SCALE_IN: スケーリンググループのスケールインイベント。

説明

スケーリンググループにライフサイクルフックが指定されている場合、このパラメーターは必須です。他の関連パラメーターは任意です。

SCALE_OUT

NotificationMetadata

string

任意

スケーリングアクティビティの待機状態の固定文字列情報。パラメーター値は 128 文字を超えることはできません。Auto Scaling が通知の受信者にメッセージをプッシュするたびに、指定した NotificationMetadata パラメーター値も送信されるため、さまざまなカテゴリの通知情報を管理およびマークするのに役立ちます。このパラメーターは、NotificationArn パラメーターも指定されている場合にのみ効果を持ちます。フォーマットと時間の詳細はドキュメントを参照してください。

Test

NotificationArn

string

任意

ライフサイクルフックの通知の受信者識別子。次のタイプの通知オブジェクトがサポートされています: Simple メッセージキュー (旧 MNS) キューおよびトピック。パラメーター値を次のフォーマットで指定します: acs:ess:{region}:{account-id}:{resource-relative-id}。

  • region: スケーリンググループが存在するリージョン。

  • account-id: Alibaba Cloud アカウント ID。

  • resource-relative-id: リソース相対 ID。

例:

  • MNS キュー: acs:ess:{region}:{account-id}:queue/{queuename}。

  • MNS トピック: acs:ess:{region}:{account-id}:topic/{topicname}。

acs:ess:cn-hangzhou:1111111111:キュー/キュー2

HeartbeatTimeout

integer

任意

スケーリンググループアクティビティに対してライフサイクルフックによってセットされる待機時間。待機状態がタイムアウトした後、次の操作が実行されます。有効な値: 30~21600。単位: 秒。

ライフサイクルフックの作成後、 RecordLifecycleActionHeartbeat を呼び出して ECS インスタンスの待機時間を延長するか、 CompleteLifecycleAction を呼び出してスケーリングアクティビティの待機状態を早期に終了させることができます。

デフォルト値: 600。

600

VServerGroup

array<object>

任意

スケーリンググループに関連付けられた仮想サービスグループに関する情報。フォーマットに従ってください。

array<object>

任意

スケーリンググループに関連付けられた仮想サービスグループに関する情報。フォーマットに従ってください。

VServerGroupAttribute

array<object>

任意

バックエンドサーバーグループの属性。

object

任意

バックエンドサーバーグループの属性。

VServerGroupId

string

任意

仮想サービスグループの ID。フォーマットに従ってください。

詳細については、「 AttachVServerGroups 」を参照してください。

rsp-bp1443g77****

Weight

integer

任意

Auto Scaling がインスタンスを仮想サービスグループに追加した後の、バックエンドサーバーとしてのインスタンスの重み。重みが大きいほど、インスタンスにより多くのアクセスリクエストが割り当てられます。重みが 0 の場合、インスタンスはアクセスリクエストを受信しません。有効な値: 0~100。デフォルト値: 50。フォーマットの詳細はドキュメントを参照してください。

詳細については、「 AttachVServerGroups 」を参照してください。

100

Port

integer

任意

Auto Scaling がインスタンスを仮想サービスグループに追加した後にインスタンスによって使用されるポート番号。有効な値: 1~65535。フォーマットの詳細はドキュメントを参照してください。

詳細については、「 AttachVServerGroups 」を参照してください。

22

LoadBalancerId

string

任意

仮想サービスグループが属する CLB (旧 SLB) インスタンスの ID。フォーマットに従ってください。

詳細については、「 AttachVServerGroups 」を参照してください。

lb-bp1u7etiogg38yvwz****

Tag

array<object>

任意

スケーリンググループのタグ。

object

任意

スケーリンググループのタグ。

Key

string

任意

スケーリンググループのタグキー。

部門

Value

string

任意

スケーリンググループのタグ値。

財務

Propagate

boolean

任意

タグが伝播可能なタグかどうかを指定します。有効な値:

  • true: スケーリンググループのタグは、新しく作成されたインスタンスにのみ伝播され、スケーリンググループ内で既に実行中のインスタンスには伝播されません。

  • false: スケーリンググループのタグはインスタンスに伝播されません。

デフォルト値: false。

false

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 つのパラメーターは互いに対応し、N は一致している必要があります。

このパラメーターはインスタンスタイプの重みを指定します。これは、スケーリンググループ内のこのタイプの単一インスタンスの容量を表します。重みが大きいほど、予想される容量を満たすために必要なこのタイプのインスタンス数が少なくなります。

インスタンスタイプは vCPU の数やメモリサイズなどのパフォーマンスメトリクスが異なるため、要件に基づいて異なるインスタンスタイプに異なる重みを割り当てることができます。

例:

  • 現在の容量: 0。

  • 予想される容量: 6。

  • ecs.c5.xlarge の容量: 4。

予想される容量を満たすために、スケーリンググループは 2 個の ecs.c5.xlarge インスタンスをスケールアウトします。

説明

スケールアウトイベント中、スケーリンググループの容量は、最大容量 (MaxSize) の最大値とインスタンスタイプの最大重みの合計を超えることはできません。

WeightedCapacity の有効な値: 1~500。

4

SpotPriceLimit

number

任意

LaunchTemplateOverride.N.InstanceType で指定されたインスタンスタイプの最大入札価格の最大値。このパラメーターに N 個の値を指定して、起動テンプレートを拡張し、N 個のインスタンスタイプをサポートできます。N の有効な値: 1~20。

説明

このパラメーターは、LaunchTemplateId パラメーターに起動テンプレートが指定されている場合にのみ効果を持ちます。

0.025

AlbServerGroup

array<object>

任意

ALB サーバーグループの情報。

object

任意

ALB サーバーグループの情報。

AlbServerGroupId

string

任意

ALB サーバーグループの ID。

N は ALB サーバーグループの番号を指定します。スケーリンググループに関連付けられる ALB サーバーグループの数には制限があります。クォータの表示または引き上げリクエストを行うには、クォータセンター コンソールに移動してください。

sgp-ddwb0y0g6y9bjm****

Weight

integer

任意

Auto Scaling によってインスタンスが ALB サーバーグループに追加された後の、バックエンドサーバーとしてのインスタンスの重み。重みが大きいほど、インスタンスはより多くのリクエストを受信します。重みが 0 の場合、インスタンスはリクエストを受信しません。有効な値: 0~100。

N は ALB サーバーグループの番号を指定します。

100

Port

integer

任意

Auto Scaling によってインスタンスが ALB サーバーグループに追加された後にインスタンスによって使用されるポート番号。有効な値: 1~65535。

N は ALB サーバーグループの番号を指定します。

説明

N の値が同じで Port の値が異なる場合、システムは異なるポートで ALB サーバーグループをスケーリンググループに複数回関連付けます。

22

ServerGroup

array<object>

任意

負荷分散サーバーグループの情報。

説明

AlbServerGroupsServerGroups の両方に同じサーバーグループ情報を設定することはできません。

object

任意

負荷分散サーバーグループの情報。

ServerGroupId

string

任意

サーバーグループの ID。

sgp-5yc3bd9lfyh*****

Type

string

任意

サーバーグループのタイプ。有効な値:

  • ALB: Application Load Balancer (ALB)。

  • NLB: Network Load Balancer (NLB)。

  • GWLB: Gateway Load Balancer (GWLB)。

ALB

Weight

integer

任意

Auto Scaling によってインスタンスがサーバーグループに追加された後の、バックエンドサーバーとしてのインスタンスの重み。有効な値: 0~100。

重みが大きいほど、インスタンスにより多くのアクセスリクエストが割り当てられます。重みが 0 の場合、インスタンスはアクセスリクエストを受信しません。

説明

このパラメーターは、ALB および NLB 負荷分散サーバーグループで必須です。GWLB 負荷分散サーバーグループではこのパラメーターを設定できません。

100

Port

integer

任意

Auto Scaling によってインスタンスがサーバーグループに追加された後にインスタンスによって使用されるポート番号。有効な値: 1~65535。

説明

このパラメーターは、ALB および NLB 負荷分散サーバーグループで必須です。GWLB 負荷分散サーバーグループではこのパラメーターを設定できません。GWLB のデフォルト値は 6081 です。

22

AzBalance

boolean

任意

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

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

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

デフォルト値: false。

false

AllocationStrategy

string

任意

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

  • priority: 設定されたインスタンスタイプの優先度に基づいてインスタンスが作成されます。

  • lowestPrice: インスタンスタイプの vCPU あたりの単価の昇順に基づいてインスタンスが作成されます。

デフォルト値: priority。

優先度

SpotAllocationStrategy

string

任意

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

  • priority: 設定されたインスタンスタイプの優先度に基づいてインスタンスが作成されます。

  • lowestPrice: インスタンスタイプの vCPU あたりの単価の昇順に基づいてインスタンスが作成されます。

デフォルト値: priority。

lowestPrice

MaxInstanceLifetime

integer

任意

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

有効な値: [86400, Integer.maxValue]

デフォルト値: null。

説明

このパラメーターは、Elastic Container Instance (ECI) タイプのスケーリンググループ、または節約モードが有効なスケーリンググループではサポートされていません。

86400

CustomPolicyARN

string

任意

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

acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_ポリシー.LATEST/関数/ess_custom_terminate_ポリシー_name

ResourceGroupId

string

任意

スケーリンググループが属するリソースグループの ID。

説明

新しく作成されたスケーリンググループは、指定されたリソースグループに追加されます。このパラメーターを指定しない場合、スケーリンググループはデフォルトのリソースグループに追加されます。

rg-123****

LoadBalancerConfig

array<object>

任意

Classic Load Balancer (CLB、旧 SLB) インスタンスの構成。

object

任意

Classic Load Balancer (CLB、旧 SLB) インスタンスの構成。

LoadBalancerId

string

任意

Classic Load Balancer (CLB、旧 SLB) インスタンスの ID。

147b46d767c-cn-qingdao-cm5****

Weight

integer

任意

Auto Scaling によってインスタンスが CLB (旧 SLB) サーバーグループに追加された後の、バックエンドサーバーとしてのインスタンスの重み。重みが大きいほど、インスタンスにより多くのアクセスリクエストが割り当てられます。重みが 0 の場合、インスタンスはアクセスリクエストを受信しません。

有効な値: 0~100。

10

HealthCheckTypes

array

任意

スケーリンググループのヘルスチェックモード。

説明

このパラメーターを使用して、複数のヘルスチェックモードを指定できます。HealthCheckType パラメーターが指定されている場合、このパラメーターは無視されます。

string

任意

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

  • NONE: ヘルスチェックが無効です。

  • ECS: スケーリンググループ内のインスタンスに対してヘルスチェックが実行されます。この値は、ECS タイプと ECI タイプの両方のスケーリンググループに適用されます。

  • LOAD_BALANCER: インスタンスのヘルスステータスは、負荷分散のヘルスチェック結果に基づいて決定されます。CLB タイプの負荷分散はサポートされていません。

デフォルト値: ECS。

ECS

DBInstance

array<object>

任意

スケーリンググループに関連付けられているデータベース。

object

任意

スケーリンググループに関連付けられているデータベースの構成。

DBInstanceId

string

任意

データベースのインスタンス ID。

rm-m5eqju85s45mu0***

Type

string

任意

データベースのタイプ。有効な値:

  • RDS。

  • Redis。

  • MongoDB。

デフォルト値: RDS。

RDS

AttachMode

string

任意

スケーリンググループがデータベースに関連付けられるモード。有効な値:

  • SecurityIp: IP ホワイトリストモード。スケールアウトイベント中に追加されたインスタンスは、データベースの IP ホワイトリストに自動的に追加されます。RDS データベースのみがサポートされています。

  • SecurityGroup: セキュリティグループモード。スケーリング設定で指定されたセキュリティグループがデータベースのセキュリティグループホワイトリストに追加され、セキュリティグループ内のインスタンスがデータベースにアクセスできるようになります。

SecurityIp

StopInstanceTimeout

integer

任意

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

説明
  • このパラメーターは、ScalingPolicy がリリースに設定されている場合のスケールインプロセス中のみ効果があります。

  • このパラメーターが指定されている場合、システムは StopInstanceTimeout 期間までインスタンスが停止するのを待ちます。タイムアウト後、インスタンスが停止したかどうかに関係なく、スケールインプロセスが継続されます。

  • このパラメーターが指定されていない場合、システムはインスタンスが停止するのを無期限に待ちます。スケールインプロセスは、インスタンスが停止した後にのみ継続されます。インスタンスの停止に失敗した場合、スケールインプロセスはロールバックされ、失敗します。

60

CapacityOptions

object

任意

容量オプション。

OnDemandBaseCapacity

integer

任意

スケーリンググループに必須の従量課金インスタンスの最小値。スケーリンググループ内の従量課金インスタンスの数がこの値未満の場合、システムは従量課金インスタンスを優先的に作成します。有効な値: 0~1000。

MultiAZPolicy が COMPOSABLE に設定されている場合、デフォルト値は 0 です。

30

OnDemandPercentageAboveBaseCapacity

integer

任意

OnDemandBaseCapacity 値を超える追加インスタンスの中の従量課金インスタンスの割合。有効な値: 0~100。

MultiAZPolicy が COMPOSABLE に設定されている場合、デフォルト値は 100 です。

20

CompensateWithOnDemand

boolean

任意

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

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

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

デフォルト値: true。

true

SpotAutoReplaceOnDemand

boolean

任意

CompensateWithOnDemand が有効になった後、従量課金の割合が OnDemandPercentageAboveBaseCapacity 値を超えた場合に、スポットインスタンスを使用して従量課金インスタンスを置き換えるかどうかを指定します。一般的なシナリオは、CompensateWithOnDemand によって引き起こされたスポットインスタンスの在庫または価格の問題により、スポットインスタンスが従量課金インスタンスにダウングレードされた場合です。従量課金インスタンスが長期間存続するのを防ぐため、システムは過剰な従量課金容量をスポットインスタンスに置き換えようとします。有効な値:

  • true: 許可されます。

  • false: 許可されません。

デフォルト値: false。

false

PriceComparisonMode

string

任意

スケーリンググループのコスト最適化戦略の価格比較モード。有効な値:

  • PricePerUnit: 容量単位あたりの価格に基づいて価格を比較します。

    スケーリンググループ内のインスタンスの容量は、インスタンスタイプに対して設定された重みに等しくなります。デフォルトの重みは 1 で、1 つの ECS インスタンスが 1 の容量を占有することを意味します。

  • PricePerVCpu: vCPU あたりの価格に基づいて価格を比較します。

デフォルト値: PricePerUnit。

PricePerUnit

BalanceMode

string

任意

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

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

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

デフォルト値: BalancedBestEffort。

BalancedBestEffort

AutoRebalance

boolean

任意

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

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

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

デフォルト値: false。

false

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ScalingGroupId

string

スケーリンググループ ID。

asg-bp14wlu85wrpchm0****

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

404 ResourceNotAvailable.VPCNetwork The specified zone does not support vpc network or sold out.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。