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

Auto Scaling:DescribeScalingGroups

最終更新日:May 22, 2026

スケーリンググループの基本情報、インスタンス、スケーリング設定などの情報をクエリします。

今すぐお試しください

この 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:DescribeScalingGroups

get

*ScalingGroup

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

スケーリンググループが配置されているリージョン ID です。

cn-qingdao

PageNumber

integer

任意

ページ番号です。ページは 1 から始まります。

デフォルト値:1

1

PageSize

integer

任意

1 ページあたりのエントリ数です。最大値:50

デフォルト値:10

10

GroupType

string

任意

スケーリンググループで管理されるインスタンスのタイプです。有効な値:

  • ECS:Elastic Compute Service (ECS) インスタンス

  • ECI:Elastic Container Instance (ECI)

ECS

ScalingGroupIds

array

任意

クエリ対象のスケーリンググループ ID です。

非アクティブなスケーリンググループの ID はクエリ結果に含まれず、エラーも返されません。

string

任意

クエリ対象のスケーリンググループ ID です。

非アクティブなスケーリンググループの ID はクエリ結果に表示されず、エラーも返されません。

asg-bp14wlu85wrpchm0****

ScalingGroupNames

array

任意

クエリ対象のスケーリンググループ名です。

非アクティブなスケーリンググループの名前はクエリ結果に表示されず、エラーも報告されません。

string

任意

クエリ対象のスケーリンググループ名です。

非アクティブなスケーリンググループの名前はクエリ結果に表示されず、エラーも報告されません。

scalinggroup****

ScalingGroupName

string

任意

スケーリンググループの名前です。

scalinggroup****

ResourceGroupId

string

任意

クエリ対象のスケーリンググループが属するリソースグループの ID です。

説明

指定されたリソースグループにスケーリンググループが存在しない場合、クエリ結果は空となり、エラーは報告されません。

rg-123******

Tags

array<object>

任意

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

object

任意

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

Key

string

任意

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

Department

Value

string

任意

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

Finance

レスポンスフィールド

フィールド

説明

object

スケーリンググループリストの詳細情報です。

RequestId

string

リクエスト ID です。

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

PageNumber

integer

ページ番号です。

1

PageSize

integer

1 ページあたりのエントリ数です。

10

TotalCount

integer

返されたエントリの総数です。

1

ScalingGroups

array<object>

スケーリンググループです。

array<object>

スケーリンググループです。

VpcId

string

スケーリンググループが配置されている VPC の ID です。

vpc-bp1vwnn14rqpyiczj****

CreationTime

string

スケーリンググループの作成時刻です。

2014-08-14T10:58Z

TotalInstanceCount

integer

スケーリンググループ内の ECS インスタンスの総数です。

1

ScalingGroupName

string

スケーリンググループの名前です。

dyrSuvBOtO1dEdIlIbp****

SpotInstancePools

integer

スケーリンググループ内のインスタンスタイプ数です。Auto Scaling は、スケーリンググループのゾーン全体で最も低価格で提供されている複数のインスタンスタイプのプリエンプティブルインスタンスを均等に作成します。有効な値:0~10

5

StoppedCapacity

integer

スケーリンググループ内で節約モードにより停止されたインスタンス数です。

1

OnDemandPercentageAboveBaseCapacity

integer

従量課金インスタンスの最小数がしきい値に達した後の超過分における従量課金インスタンスの割合です。有効な値:0~100

20

ModificationTime

string

スケーリンググループが最後に変更された時刻です。

2014-08-14T10:58Z

MinSize

integer

スケーリンググループに含まれる必要がある ECS インスタンスの最小数です。

1

ScalingGroupId

string

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

asg-bp14wlu85wrpchm0****

CompensateWithOnDemand

boolean

MultiAZPolicy が COST_OPTIMIZED に設定されている場合、価格要因または在庫不足によりプリエンプティブルインスタンスを作成できないときに、Auto Scaling が従量課金インスタンスを作成して補完できるかどうかを示します。有効な値:

  • true

  • false

true

ScalingPolicy

string

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

  • recycle:節約モード

  • release:リリースモード

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

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

recycle

RemovingWaitCapacity

integer

スケーリンググループ内で削除待ち状態にある ECS インスタンス数です。

1

ActiveCapacity

integer

スケーリンググループ内でサービス中状態にある ECS インスタンス数です。

1

OnDemandBaseCapacity

integer

スケーリンググループに含まれる必要がある従量課金インスタンスの最小数です。有効な値:0~1000。従量課金インスタンスの数がこのパラメーターの値未満の場合、Auto Scaling は優先的に従量課金インスタンスを作成します。

30

ProtectedCapacity

integer

スケーリンググループ内で保護状態にある ECS インスタンス数です。

1

HealthCheckType

string

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

  • NONE:Auto Scaling はヘルスチェックを実行しません。

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

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

ECS

LifecycleState

string

スケーリンググループのステータスです。有効な値:

  • Active:スケーリンググループはアクティブです。アクティブなスケーリンググループは、スケーリングルールの実行リクエストを受け取り、スケーリングアクティビティをトリガーできます。

  • Inactive:スケーリンググループは無効化されています。無効化されたスケーリンググループは、スケーリングルールの実行リクエストを受け取ることができません。

  • Deleting:スケーリンググループは削除中です。削除中のスケーリンググループは、スケーリングルールの実行リクエストを受け取ることができず、パラメーター設定を変更することもできません。

Active

GroupDeletionProtection

boolean

スケーリンググループに対して削除保護機能が有効かどうかを示します。有効な値:

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

  • false:スケーリンググループに対して削除保護機能が無効です。

true

ActiveScalingConfigurationId

string

スケーリンググループ内のアクティブなスケーリング設定の ID です。

asc-bp1et2qekq3ojr33****

GroupType

string

スケーリンググループで管理されるインスタンスのタイプです。

ECS

MultiAZPolicy

string

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

  • PRIORITY:ECS インスタンスは VSwitchIds の値に基づいて作成されます。Auto Scaling が優先度が最も高い vSwitch が配置されているゾーンで ECS インスタンスを作成できない場合、次に優先度が高い vSwitch が配置されているゾーンで ECS インスタンスを作成します。

  • COST_OPTIMIZED:ECS インスタンスは vCPU の単位価格に基づいて作成されます。Auto Scaling は、最も低価格で提供されている vCPU を持つ ECS インスタンスを優先的に作成します。スケーリング設定でプリエンプティブルインスタンスタイプが指定されている場合、Auto Scaling はプリエンプティブルインスタンスを優先的に作成します。また、CompensateWithOnDemand を指定することで、在庫不足によりプリエンプティブルインスタンスを作成できない場合に、Auto Scaling が従量課金インスタンスを作成できるようにすることもできます。

    **

    注記 COST_OPTIMIZED 設定は、スケーリング設定に複数のインスタンスタイプが含まれているか、またはプリエンプティブルインスタンスタイプが含まれている場合にのみ有効になります。

  • BALANCE:ECS インスタンスは、スケーリンググループに指定されたゾーン間で均等に分散されます。インスタンスタイプの可用性が限られているために、指定されたゾーン間で ECS インスタンスの分散が不均等になった場合は、RebalanceInstance 操作を呼び出して ECS インスタンスの分散をバランスさせることができます。

PRIORITY

RemovingCapacity

integer

スケーリンググループから削除中の ECS インスタンス数です。

0

PendingWaitCapacity

integer

スケーリンググループ内で追加待ち状態にある ECS インスタンス数です。

1

StandbyCapacity

integer

スケーリンググループ内でスタンバイ状態にある ECS インスタンス数です。

1

CurrentHostName

string

説明

このパラメーターは使用できません。

hostname

PendingCapacity

integer

スケーリンググループに追加中かつ構成中の ECS インスタンス数です。

0

LaunchTemplateId

string

スケーリンググループで使用される起動テンプレートの ID です。

lt-m5e3ofjr1zn1aw7****

TotalCapacity

integer

Weighted が指定されている場合、このパラメーターはスケーリンググループ内のすべての ECS インスタンスの重み付き総容量を示します。それ以外の場合は、スケーリンググループ内の ECS インスタンスの総数を示します。

1

DesiredCapacity

integer

スケーリンググループ内の期待される ECS インスタンス数です。Auto Scaling は自動的に期待される ECS インスタンス数を維持します。

5

SpotInstanceRemedy

boolean

プリエンプティブルインスタンスを補完できるかどうかを示します。このパラメーターが true に設定されている場合、Auto Scaling はシステム通知を受信すると、回収対象のプリエンプティブルインスタンスを置き換えるために積極的にインスタンスを作成します。

true

LaunchTemplateVersion

string

スケーリンググループで使用される起動テンプレートのバージョンです。

Default

RegionId

string

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

cn-qingdao

VSwitchId

string

スケーリンググループの vSwitch ID です。

vsw-bp1whw2u46cn8zubm****

MaxSize

integer

スケーリンググループに含まれる ECS インスタンスの最大数です。

2

DefaultCooldown

integer

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

60

VServerGroups

array<object>

バックエンド vServer グループです。

array<object>

バックエンド vServer グループです。

LoadBalancerId

string

バックエンド vServer グループが属するロードバランサーの ID です。

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

VServerGroupAttributes

array<object>

バックエンド vServer グループの属性です。

object

バックエンド vServer グループの属性です。

VServerGroupId

string

バックエンド vServer グループの ID です。

rsp-bp12bjrny****

Weight

integer

バックエンド vServer グループの重みです。

1

Port

integer

ロードバランサーが外部サービスを提供するために使用するポート番号です。

22

LaunchTemplateOverrides

array<object>

起動テンプレートで拡張されたインスタンスタイプです。

object

起動テンプレートで拡張されたインスタンスタイプです。

WeightedCapacity

integer

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

4

InstanceType

string

インスタンスタイプです。このパラメーターで指定されたインスタンスタイプは、起動テンプレートで指定されたインスタンスタイプをオーバーライドします。

ecs.c5.xlarge

SpotPriceLimit

number

LaunchTemplateOverride.InstanceType で指定されたインスタンスタイプの最高入札価格です。

説明

このパラメーターは、LaunchTemplateId を使用して起動テンプレートを指定した場合にのみ有効です。

0.025

AlbServerGroups

array<object>

Application Load Balancer (ALB) サーバーグループです。

object

ALB サーバーグループです。

AlbServerGroupId

string

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

sgp-ddwb0y0g6y9bjm****

Weight

integer

ECS インスタンスが ALB サーバーグループのバックエンドサーバーとして機能する際の重みです。

100

Port

integer

ECS インスタンスが ALB サーバーグループのバックエンドサーバーとして機能する際に使用するポート番号です。

80

ServerGroups

array<object>

サーバーグループに関する情報です。

説明

このパラメーターを使用して、スケーリンググループに関連付けられた ALB、NLB、GWLB サーバーグループの情報を取得できます。

object

サーバーグループ情報です。

ServerGroupId

string

サーバーグループの ID です。

sgp-i9ouakeaerr*****

Type

string

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

  • ALB

  • NLB

  • GWLB

ALB

Weight

integer

ECS インスタンスがサーバーグループのバックエンドサーバーとして機能する際の重みです。

100

Port

integer

サーバーグループ内の各 ECS インスタンスが使用するポート番号です。

80

RemovalPolicies

array

インスタンス削除ポリシーです。有効な値:

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

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

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

string

インスタンス削除ポリシーです。有効な値:

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

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

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

OldestScalingConfiguration

DBInstanceIds

array

スケーリンググループにアタッチされている ApsaraDB RDS インスタンスの ID です。

string

スケーリンググループにアタッチされている ApsaraDB RDS インスタンスの ID です。

rm-bp15556qzebg1****

LoadBalancerIds

array

スケーリンググループにアタッチされているロードバランサーの ID です。

string

スケーリンググループにアタッチされているロードバランサーの ID です。

lb-bp19byhscefk3x0li****

VSwitchIds

array

スケーリンググループに関連付けられている vSwitch の ID です。VSwitchIds を指定した場合、VSwitchId は無視されます。

string

スケーリンググループに関連付けられている vSwitch の ID です。VSwitchIds を指定した場合、VSwitchId は無視されます。

vsw-bp1whw2u46cn8zubm****

SuspendedProcesses

array

一時停止されているプロセスです。プロセスが一時停止されていない場合、null が返されます。有効な値:

  • ScaleIn:スケールインプロセス

  • ScaleOut:スケールアウトプロセス

  • HealthCheck:ヘルスチェックプロセス

  • AlarmNotification:監視タスクプロセス

  • ScheduledAction:定期タスクプロセス

string

一時停止されているプロセスです。プロセスが一時停止されていない場合、null が返されます。有効な値:

  • ScaleIn:スケールインプロセス

  • ScaleOut:スケールアウトプロセス

  • HealthCheck:ヘルスチェックプロセス

  • AlarmNotification:監視タスクプロセス

  • ScheduledAction:定期タスクプロセス

ScaleIn

SystemSuspended

boolean

Auto Scaling がスケーリンググループ内のスケーリングアクティビティの実行を停止するかどうかを示します。有効な値:

  • true:スケーリンググループ内で 7 日以上連続してスケーリングアクティビティが失敗した場合、Auto Scaling はスケーリングアクティビティの実行を停止します。この場合、スケーリンググループまたはスケーリング設定を変更して、スケーリングアクティビティを再開する必要があります。

  • false:Auto Scaling はスケーリンググループ内のスケーリングアクティビティの実行を停止しません。

true

IsElasticStrengthInAlarm

boolean

説明

このパラメーターは使用できません。

false

MonitorGroupId

string

スケーリンググループに関連付けられている CloudMonitor アプリケーショングループの ID です。

1497****

AzBalance

boolean

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

  • true

  • false

false

AllocationStrategy

string

インスタンス割り当てポリシーです。Auto Scaling は、割り当てポリシーに基づいてインスタンスタイプを選択し、必要な数のプリエンプティブルインスタンスを作成します。このポリシーは、従量課金インスタンスおよびプリエンプティブルインスタンスに適しています。このパラメーターは、MultiAZPolicyCOMPOSABLE に設定した場合にのみ有効です。有効な値:

  • priority:Auto Scaling は、事前定義されたインスタンスタイプシーケンスを採用して、必要な数のプリエンプティブルインスタンスを作成します。

  • lowestPrice:Auto Scaling は、最も経済的な vCPU 単価を持つインスタンスタイプを選択して、必要な数のインスタンスを作成します。

priority

SpotAllocationStrategy

string

プリエンプティブルインスタンスの割り当てポリシーです。このパラメーターは、Auto Scaling がインスタンスタイプを選択して必要な数のプリエンプティブルインスタンスを作成する方法を示します。このパラメーターは、MultiAZPolicyCOMPOSABLE に設定した場合にのみ有効です。有効な値:

  • priority:Auto Scaling は、事前定義されたインスタンスタイプシーケンスを採用して、必要な数のプリエンプティブルインスタンスを作成します。

  • lowestPrice:Auto Scaling は、最も経済的な vCPU 単価を持つインスタンスタイプを選択して、必要な数のプリエンプティブルインスタンスを作成します。

デフォルト値:priority

lowestPrice

MaxInstanceLifetime

integer

スケーリンググループ内の各 ECS インスタンスの最大ライフサイクルです。単位:秒。

有効な値:0 または [86400, Integer.maxValue]。MaxInstanceLifetime の値が 0 の場合、以前に設定された制限が解除されたことを示します。これにより、インスタンスの最大ライフサイクル制約が無効になります。

デフォルト値:null

説明

このパラメーターは、Elastic Container Instance タイプのスケーリンググループおよび ScalingPolicy が Recycle に設定されているスケーリンググループではサポートされていません。

null

CustomPolicyARN

string

カスタムスケールインポリシーで指定された関数の Alibaba Cloud リソースネーム (ARN) です。このパラメーターは、RemovalPolicies の最初の値を CustomPolicy に設定した場合にのみ有効です。

acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name

InitCapacity

integer

スケーリンググループに追加される前に初期化されるインスタンス数です。

0

ResourceGroupId

string

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

rg-123****

LoadBalancerConfigs

array<object>

ロードバランサーの設定です。

object

ロードバランサーの設定です。

LoadBalancerId

string

CLB インスタンスの ID です。

lb-2zep8alpq5zq1a2xwyxxx

Weight

integer

ECS インスタンスが CLB サーバーグループのバックエンドサーバーとして機能する際の重みです。ECS インスタンスの重みを増やすと、その ECS インスタンスに転送されるアクセスリクエストの数が増えます。ECS インスタンスの重みを 0 に設定すると、アクセスリクエストはその ECS インスタンスに転送されません。有効な値:0~100

10

EnableDesiredCapacity

boolean

期待インスタンス数機能が有効かどうかを示します。有効な値:

  • true

  • false

false

Tags

array<object>

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

object

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

TagKey

string

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

Department

TagValue

string

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

Finance

Propagate

boolean

スケーリンググループのタグをインスタンスに伝播できるかどうかを示します。有効な値:

  • true:スケーリンググループのタグは新しいインスタンスにのみ伝播されます。

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

デフォルト値:false

false

HealthCheckTypes

array

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

  • NONE:Auto Scaling はヘルスチェックを実行しません。

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

  • LOAD_BALANCER:Auto Scaling はロードバランサーのヘルスチェック結果に基づいて、スケーリンググループ内のインスタンスのヘルスステータスをチェックします。CLB インスタンスのヘルスチェック結果は、スケーリンググループ内のインスタンスのヘルスチェック基準としてサポートされていません。

string

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

  • NONE:Auto Scaling はヘルスチェックを実行しません。

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

  • LOAD_BALANCER:Auto Scaling はロードバランサーのヘルスチェック結果に基づいて、スケーリンググループ内のインスタンスのヘルスステータスをチェックします。CLB インスタンスのヘルスチェック結果は、スケーリンググループ内のインスタンスのヘルスチェック基準としてサポートされていません。

ECS

DBInstances

array<object>

スケーリンググループにアタッチされているデータベースです。

object

スケーリンググループにアタッチされているデータベースです。

DBInstanceId

string

データベースの ID です。

rm-m5eqju85s45mu0***

Type

string

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

  • RDS

  • Redis

  • MongoDB

RDS

SecurityGroupIds

array

アタッチされたデータベースのセキュリティグループホワイトリストに追加されるセキュリティグループの ID です。

string

アタッチされたデータベースのセキュリティグループホワイトリストに追加されるセキュリティグループの ID です。

DetachDBInstances 操作で RemoveSecurityGrouptrue に設定した場合、このパラメーターで指定されたセキュリティグループは、アタッチされたデータベースのセキュリティグループホワイトリストから削除されます。

sg-uf65zt66cf2a0q47***

SpotCapacity

integer

スケーリンググループ内のプリエンプティブルインスタンス数です。

0

StopInstanceTimeout

integer

スケールインプロセス中に Elastic Compute Service (ECS) インスタンスが停止状態になるまでに必要な時間です。単位:秒。

60

CapacityOptions

object

容量オプションです。

OnDemandBaseCapacity

integer

スケーリンググループに必要な従量課金インスタンスの最小数です。従量課金インスタンスの実際の数が最小しきい値を下回った場合、Auto Scaling は優先的に従量課金インスタンスを作成します。有効な値:0~1000

0

OnDemandPercentageAboveBaseCapacity

integer

従量課金インスタンスの最小数に達した後の超過インスタンスにおける従量課金インスタンスの割合です。OnDemandBaseCapacity は、スケーリンググループに必要な従量課金インスタンスの最小数を指定します。有効な値:0~100

0

CompensateWithOnDemand

boolean

高価格またはリソースの在庫不足によりプリエンプティブル ECS インスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金 ECS インスタンスを自動的に作成できるかどうかを示します。このパラメーターは、MultiAZPolicyCOST_OPTIMIZED に設定した場合にのみ有効です。有効な値:

  • true

  • false

true

SpotAutoReplaceOnDemand

boolean

従量課金 ECS インスタンスをプリエンプティブル ECS インスタンスに置き換えるかどうかを指定します。CompensateWithOnDemand を指定すると、OnDemandPercentageAboveBaseCapacity の値と比較して従量課金インスタンスの割合が高くなる可能性があります。このようなシナリオでは、Auto Scaling は余剰の従量課金 ECS インスタンスを置き換えるためにプリエンプティブル ECS インスタンスのデプロイを試みます。CompensateWithOnDemand を指定すると、十分なプリエンプティブルインスタンスタイプが利用できない場合、Auto Scaling は従量課金 ECS インスタンスを作成します。これらの従量課金 ECS インスタンスを長期間保持しないようにするために、十分なプリエンプティブルインスタンスタイプが利用可能になった時点で、Auto Scaling はそれらをプリエンプティブルインスタンスに置き換えようと試みます。有効な値:

  • true

  • false

false

PriceComparisonMode

string

価格の比較方法を示します。有効な値:

  • PricePerUnit:インスタンス容量あたりの価格に基づいて価格を比較します。

    容量は、スケーリンググループ内のインスタンスタイプに割り当てられた重みによって決定されます。重みが指定されていない場合、デフォルトの重み 1 が使用され、各インスタンスに容量 1 が割り当てられます。

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

PricePerUnit

BalanceMode

string

ゾーンバランスモードです。このモードは、ゾーンバランスモードが有効になっている場合にのみ有効です。有効な値:

  • デフォルト値:BalancedBestEffort。ゾーンでリソースの作成に失敗した場合、そのリソースは別のゾーンにスペックダウンされます。これにより、リソースのベストエフォート型配信が保証されます。

  • BalancedOnly:ゾーンでリソースの作成に失敗した場合、そのリソースは別のゾーンにスペックダウンされません。スケールアウトアクティビティは部分的に成功し、異なるゾーン間でのリソースの過度な不均衡を回避します。

BalancedBestEffort

AutoRebalance

boolean

スケーリンググループの自動リバランスを有効にするかどうかを示します。これは、スケーリンググループに対して BalancedOnly が有効になっている場合にのみ有効です。有効な値:

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

  • true:自動リバランスが有効になっている場合、スケーリンググループはゾーンの容量を自動的に検出します。ゾーンの容量が不均衡である場合、スケーリンググループはゾーンを積極的にスケールアウトし、ゾーンの容量を再バランスします。

false

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "ScalingGroups": [
    {
      "VpcId": "vpc-bp1vwnn14rqpyiczj****",
      "CreationTime": "2014-08-14T10:58Z",
      "TotalInstanceCount": 1,
      "ScalingGroupName": "dyrSuvBOtO1dEdIlIbp****",
      "SpotInstancePools": 5,
      "StoppedCapacity": 1,
      "OnDemandPercentageAboveBaseCapacity": 20,
      "ModificationTime": "2014-08-14T10:58Z",
      "MinSize": 1,
      "ScalingGroupId": "asg-bp14wlu85wrpchm0****",
      "CompensateWithOnDemand": true,
      "ScalingPolicy": "recycle",
      "RemovingWaitCapacity": 1,
      "ActiveCapacity": 1,
      "OnDemandBaseCapacity": 30,
      "ProtectedCapacity": 1,
      "HealthCheckType": "ECS",
      "LifecycleState": "Active",
      "GroupDeletionProtection": true,
      "ActiveScalingConfigurationId": "asc-bp1et2qekq3ojr33****",
      "GroupType": "ECS",
      "MultiAZPolicy": "PRIORITY",
      "RemovingCapacity": 0,
      "PendingWaitCapacity": 1,
      "StandbyCapacity": 1,
      "CurrentHostName": "hostname",
      "PendingCapacity": 0,
      "LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****",
      "TotalCapacity": 1,
      "DesiredCapacity": 5,
      "SpotInstanceRemedy": true,
      "LaunchTemplateVersion": "Default",
      "RegionId": "cn-qingdao",
      "VSwitchId": "vsw-bp1whw2u46cn8zubm****",
      "MaxSize": 2,
      "DefaultCooldown": 60,
      "VServerGroups": [
        {
          "LoadBalancerId": "147b46d767c-cn-qingdao-cm5****",
          "VServerGroupAttributes": [
            {
              "VServerGroupId": "rsp-bp12bjrny****",
              "Weight": 1,
              "Port": 22
            }
          ]
        }
      ],
      "LaunchTemplateOverrides": [
        {
          "WeightedCapacity": 4,
          "InstanceType": "ecs.c5.xlarge",
          "SpotPriceLimit": 0.025
        }
      ],
      "AlbServerGroups": [
        {
          "AlbServerGroupId": "sgp-ddwb0y0g6y9bjm****",
          "Weight": 100,
          "Port": 80
        }
      ],
      "ServerGroups": [
        {
          "ServerGroupId": "sgp-i9ouakeaerr*****",
          "Type": "ALB",
          "Weight": 100,
          "Port": 80
        }
      ],
      "RemovalPolicies": [
        "OldestScalingConfiguration"
      ],
      "DBInstanceIds": [
        "rm-bp15556qzebg1****"
      ],
      "LoadBalancerIds": [
        "lb-bp19byhscefk3x0li****"
      ],
      "VSwitchIds": [
        "vsw-bp1whw2u46cn8zubm****"
      ],
      "SuspendedProcesses": [
        "ScaleIn"
      ],
      "SystemSuspended": true,
      "IsElasticStrengthInAlarm": false,
      "MonitorGroupId": "1497****",
      "AzBalance": false,
      "AllocationStrategy": "priority",
      "SpotAllocationStrategy": "lowestPrice",
      "MaxInstanceLifetime": 0,
      "CustomPolicyARN": "acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name",
      "InitCapacity": 0,
      "ResourceGroupId": "rg-123****",
      "LoadBalancerConfigs": [
        {
          "LoadBalancerId": "lb-2zep8alpq5zq1a2xwyxxx",
          "Weight": 10
        }
      ],
      "EnableDesiredCapacity": false,
      "Tags": [
        {
          "TagKey": "Department",
          "TagValue": "Finance",
          "Propagate": false
        }
      ],
      "HealthCheckTypes": [
        "ECS"
      ],
      "DBInstances": [
        {
          "DBInstanceId": "rm-m5eqju85s45mu0***\n",
          "Type": "RDS",
          "SecurityGroupIds": [
            "sg-uf65zt66cf2a0q47***"
          ]
        }
      ],
      "SpotCapacity": 0,
      "StopInstanceTimeout": 60,
      "CapacityOptions": {
        "OnDemandBaseCapacity": 0,
        "OnDemandPercentageAboveBaseCapacity": 0,
        "CompensateWithOnDemand": true,
        "SpotAutoReplaceOnDemand": false,
        "PriceComparisonMode": "PricePerUnit"
      },
      "BalanceMode": "BalancedBestEffort",
      "AutoRebalance": false
    }
  ]
}

エラーコード

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

変更履歴

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