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