スケーリンググループ ID を指定して、スケーリンググループ内の ECS インスタンスのリストと詳細を照会します。実行中のスポットインスタンスの合計数、ECS インスタンスの合計数、ECS インスタンスのウォームアップ状態、現在のスケーリンググループにおけるライフサイクル状態などが含まれます。ヘルスチェックステータス、ライフサイクル状態、または作成タイプで ECS インスタンスをフィルターすることもできます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:DescribeScalingInstances |
get |
*ScalingGroup
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
スケーリンググループのリージョン ID。 |
cn-hangzhou |
| ScalingGroupId |
string |
任意 |
スケーリンググループの ID。 |
asg-bp1igpak5ft1flyp**** |
| ScalingConfigurationId |
string |
任意 |
関連付けられたスケーリング設定の ID。 |
asc-bp1i65jd06v04vdh**** |
| HealthStatus |
string |
任意 |
スケーリンググループ内の ECS インスタンスのヘルスチェックステータス。Running 状態でない ECS インスタンスは異常とみなされます。有効な値:
Auto Scaling は異常な ECS インスタンスをスケーリンググループから自動的に削除し、自動作成によって作成された ECS インスタンスをリリースします。 手動で追加された ECS インスタンスがリリースされるかどうかは、その管理状態によって異なります。インスタンスのライフサイクルがスケーリンググループによって管理されていない場合、インスタンスは削除されるだけでリリースされません。インスタンスのライフサイクルがスケーリンググループによって管理されている場合、インスタンスは削除およびリリースされます。 説明
アカウントに十分な利用可能クォータがあることを確認してください。アカウントに支払い遅延がある場合、すべての従量課金 ECS インスタンス (従量課金インスタンスおよびスポットインスタンスを含む) が停止またはリリースされます。支払い遅延が発生した後のスケーリンググループ内の ECS インスタンスのステータス変化については、料金滞納について を参照してください。 |
Healthy |
| LifecycleState |
string |
任意 |
スケーリンググループ内の ECS インスタンスのライフサイクル状態。有効な値:
|
InService |
| CreationType |
string |
任意 |
スケーリンググループ内でインスタンスを作成するために使用されたメソッド。有効な値:
|
AutoCreated |
| PageNumber |
integer |
任意 |
ECS インスタンスリストのページ番号。最小値: 1。 デフォルト値: 1。 |
1 |
| PageSize |
integer |
任意 |
ページあたりのエントリ数。最大値: 100。 デフォルト値: 10。 |
10 |
| ScalingActivityId |
string |
任意 |
スケーリングアクティビティの ID。 |
asa-bp1c9djwrgxjyk31**** |
| InstanceIds |
array |
任意 |
ECS インスタンスの ID。 無効な InstanceId 値はクエリ結果で無視され、エラーは返されません。 |
|
|
string |
任意 |
ECS インスタンスの ID。 無効な InstanceId 値はクエリ結果で無視され、エラーは返されません。 |
i-bp109k5j3dum1ce6**** |
|
| CreationTypes |
array |
任意 |
スケーリンググループ内でインスタンスを作成するために使用されたメソッド。このパラメーターと CreationType のいずれか一方のみを指定できます。 |
|
|
string |
任意 |
スケーリンググループ内でインスタンスを作成するために使用されたメソッド。有効な値: AutoCreated、Attached、Managed。 |
AutoCreated |
|
| LifecycleStates |
array |
任意 |
スケーリンググループ内の ECS インスタンスのライフサイクル状態。このパラメーターと LifecycleState のいずれか一方のみを指定できます。LifecycleState の代わりにこのパラメーターを使用してください。 |
|
|
string |
任意 |
スケーリンググループ内の ECS インスタンスのライフサイクル状態。有効な値:
|
InService |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
B13527BF-1FBD-4334-A512-20F5E9D3FB4D |
| PageSize |
integer |
ページあたりのエントリ数。 |
10 |
| PageNumber |
integer |
返されたページのページ番号。 |
1 |
| TotalSpotCount |
integer |
現在のスケーリンググループ内で実行中のスポットインスタンスの合計数。 |
4 |
| TotalCount |
integer |
ECS インスタンスの合計数。 |
1 |
| ScalingInstances |
array<object> |
ECS インスタンス情報のコレクション。 |
|
|
object |
ECS インスタンス情報のコレクション。 |
||
| CreationTime |
string |
ECS インスタンスがスケーリンググループに追加された時間。値は分単位まで正確です。 |
2020-05-18T03:11Z |
| LoadBalancerWeight |
integer |
負荷分散インスタンスの重み。 説明
このパラメーターは非推奨であり、使用は推奨されません。 |
50 |
| LaunchTemplateId |
string |
起動テンプレートの ID。 |
lt-m5e3ofjr1zn1aw7**** |
| InstanceId |
string |
ECS インスタンスの ID。 |
i-bp109k5j3dum1ce6**** |
| SpotStrategy |
string |
スポットインスタンスのプリエンプションポリシー。有効な値:
|
SpotWithPriceLimit |
| LaunchTemplateVersion |
string |
起動テンプレートのバージョン。 |
1 |
| HealthStatus |
string |
スケーリンググループ内の ECS インスタンスのヘルスチェックステータス。Running 状態でない ECS インスタンスは異常とみなされます。有効な値:
Auto Scaling は異常な ECS インスタンスをスケーリンググループから自動的に削除し、自動作成によって作成された ECS インスタンスをリリースします。 手動で追加された ECS インスタンスがリリースされるかどうかは、その管理状態によって異なります。インスタンスのライフサイクルがスケーリンググループによって管理されていない場合、インスタンスは削除されるだけでリリースされません。インスタンスのライフサイクルがスケーリンググループによって管理されている場合、インスタンスは削除およびリリースされます。 説明
アカウントに十分な利用可能クォータがあることを確認してください。アカウントに支払い遅延がある場合、すべての従量課金 ECS インスタンス (従量課金インスタンスおよびスポットインスタンスを含む) が停止またはリリースされます。支払い遅延が発生した後のスケーリンググループ内の ECS インスタンスのステータス変化については、料金滞納について を参照してください。 |
Healthy |
| ScalingGroupId |
string |
インスタンスが属するスケーリンググループの ID。 |
asg-bp1igpak5ft1flyp**** |
| WarmupState |
string |
ECS インスタンスのウォームアップ状態。有効な値:
|
NoNeedWarmup |
| LifecycleState |
string |
スケーリンググループ内の ECS インスタンスのライフサイクル状態。有効な値:
|
InService |
| CreationType |
string |
ECS インスタンスの作成に使用されたメソッド。有効な値:
|
AutoCreated |
| ZoneId |
string |
ECS インスタンスのゾーン ID。 |
cn-hangzhou-g |
| ScalingConfigurationId |
string |
関連付けられたスケーリング設定の ID。 |
asc-bp1i65jd06v04vdh**** |
| Entrusted |
boolean |
手動で追加されたインスタンスがスケーリンググループによって管理されているかどうかを示します。管理されている手動追加インスタンスは、スケーリンググループから削除される際にリリースされます (手動削除を除く)。有効な値:
|
true |
| WeightedCapacity |
integer |
インスタンスタイプの重み。重みは、このインスタンスタイプの単一インスタンスがスケーリンググループ内で表す容量を示します。重みが高いほど、期待される容量を満たすために必要なこのタイプのインスタンス数が少なくなります。 |
4 |
| CreatedTime |
string |
ECS インスタンスがスケーリンググループに追加された時間。値は秒単位まで正確です。 |
2020-05-18T03:11:39Z |
| ScalingActivityId |
string |
ECS インスタンスがスケーリンググループに追加されたスケーリングアクティビティの ID。 |
asa-bp1c9djwrgxjyk31**** |
| ScalingInstanceId |
string |
スケーリンググループ内のインスタンスアイデンティティ。ECS インスタンス ID または Elastic Container Instance (ECI) インスタンスアイデンティティと一対一のマッピングを持ちます。 |
asi-j6cj1gcte640ekhb**** |
| PrivateIpAddress |
string |
スケーリンググループ内のインスタンスの非公開 IP アドレス。 |
1**.2*.1**.2** |
| ReplaceStatus |
string |
例
成功レスポンス
JSONJSON
{
"RequestId": "B13527BF-1FBD-4334-A512-20F5E9D3****",
"PageSize": 10,
"PageNumber": 1,
"TotalSpotCount": 4,
"TotalCount": 1,
"ScalingInstances": [
{
"CreationTime": "2020-05-18T03:11Z",
"LoadBalancerWeight": 50,
"LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****",
"InstanceId": "i-bp109k5j3dum1ce6****",
"SpotStrategy": "SpotWithPriceLimit",
"LaunchTemplateVersion": "1",
"HealthStatus": "Healthy",
"ScalingGroupId": "asg-bp1igpak5ft1flyp****",
"WarmupState": "NoNeedWarmup",
"LifecycleState": "InService",
"CreationType": "AutoCreated",
"ZoneId": "cn-hangzhou-g",
"ScalingConfigurationId": "asc-bp1i65jd06v04vdh****",
"Entrusted": true,
"WeightedCapacity": 4,
"CreatedTime": "2020-05-18T03:11:39Z",
"ScalingActivityId": "asa-bp1c9djwrgxjyk31****",
"ScalingInstanceId": "asi-j6cj1gcte640ekhb****",
"PrivateIpAddress": "1**.2*.1**.2**"
}
]
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。