スケーリンググループ 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 インスタンスのヘルスチェックステータス。実行中のインスタンスステータスではない ECS インスタンスは、異常とみなされます。有効な値:
Auto Scaling は、異常な ECS インスタンスをスケーリンググループから自動的に削除し、自動作成によって作成された ECS インスタンスをリリースします。 手動で追加された ECS インスタンスがリリースされるかどうかは、そのホスト状態によって異なります。インスタンスのライフサイクルがスケーリンググループによって管理されていない場合、インスタンスは削除のみされ、リリースされません。インスタンスのライフサイクルがスケーリンググループによって管理されている場合、インスタンスは削除され、リリースされます。 説明
アカウントに十分なアクティブなクォータがあることを確認してください。アカウントに支払い遅延がある場合、すべての従量課金制 ECS インスタンス(従量課金制インスタンスおよびスポットインスタンスを含む)が停止、またはリリースされる可能性があります。支払い遅延発生後のスケーリンググループ内の ECS インスタンスのステータス変化の詳細については、「料金滞納について」をご参照ください。 |
Healthy |
| LifecycleState |
string |
任意 |
スケーリンググループ内の ECS インスタンスのライフサイクル状態。有効な値:
|
InService |
| CreationType |
string |
任意 |
スケーリンググループ内のインスタンスの作成に使用されたメソッド。有効な値:
|
AutoCreated |
| PageNumber |
integer |
任意 |
ECS インスタンスリストのページ番号。最小値: 1。 デフォルト値: 1。 |
1 |
| PageSize |
integer |
任意 |
ページングクエリの 1 ページあたりのエントリ数。最大値: 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 のいずれか一方のみを指定できます。このパラメーターの使用を推奨します。 |
|
|
string |
任意 |
スケーリンググループ内の ECS インスタンスのライフサイクル状態。有効な値:
|
InService |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
B13527BF-1FBD-4334-A512-20F5E9D3**** |
| PageSize |
integer |
1 ページあたりのエントリ数。 |
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 インスタンスのヘルスチェックステータス。実行中のインスタンスステータスではない 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 |
スケーリンググループ内のインスタンス ID。ECS インスタンス ID または ECI インスタンス 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": [
{
"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**",
"ReplaceStatus": "ReBalance"
}
]
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。