调用DescribeScalingInstances,通过伸缩组ID查询该伸缩组内的ECS实例列表及实例信息,包括当前伸缩组中,运行状态的抢占式实例总数、ECS实例总数、ECS实例的预热状态、生命周期状态等。同时也支持指定实例健康状态、生命周期状态、创建方式等筛选符合要求的ECS实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ess:DescribeScalingInstances |
get |
*ScalingGroup
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
伸缩组所属地域的 ID。 |
cn-hangzhou |
| ScalingGroupId |
string |
否 |
伸缩组的 ID。 |
asg-bp1igpak5ft1flyp**** |
| ScalingConfigurationId |
string |
否 |
关联伸缩配置的 ID。 |
asc-bp1i65jd06v04vdh**** |
| HealthStatus |
string |
否 |
ECS 实例在伸缩组中的健康状态,未处于运行中(Running)状态的 ECS 实例会被判定为不健康的 ECS 实例,取值范围:
弹性伸缩会自动移出伸缩组中不健康的 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 参数只能同时传入一个,建议您使用此参数。 |
|
|
string |
否 |
ECS 实例在伸缩组中的生命周期状态,取值范围:
|
InService |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
B13527BF-1FBD-4334-A512-20F5E9D3**** |
| 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 实例会被判定为不健康的 ECS 实例,可能值:
弹性伸缩会自动移出伸缩组中不健康的 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 实例或 ECI 实例的 ID 一一对应。 |
asi-j6cj1gcte640ekhb**** |
| PrivateIpAddress |
string |
伸缩组中实例的内网 IP 地址。 |
1**.2*.1**.2** |
| ReplaceStatus |
string |
示例
正常返回示例
JSON格式
{
"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": ""
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。