DescribeScalingInstances
調(diào)用DescribeScalingInstances,通過伸縮組ID查詢?cè)撋炜s組內(nèi)的ECS實(shí)例列表及實(shí)例信息,包括當(dāng)前伸縮組中,運(yùn)行狀態(tài)的搶占式實(shí)例總數(shù)、ECS實(shí)例總數(shù)、ECS實(shí)例的預(yù)熱狀態(tài)、生命周期狀態(tài)等。同時(shí)也支持指定實(shí)例健康狀態(tài)、生命周期狀態(tài)、創(chuàng)建方式等篩選符合要求的ECS實(shí)例。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeScalingInstances | 系統(tǒng)規(guī)定參數(shù)。取值:DescribeScalingInstances。 |
RegionId | String | 是 | cn-hangzhou | 伸縮組所屬地域的ID。 |
ScalingGroupId | String | 否 | asg-bp1igpak5ft1flyp**** | 伸縮組的ID。 |
ScalingConfigurationId | String | 否 | asc-bp1i65jd06v04vdh**** | 關(guān)聯(lián)伸縮配置的ID。 |
HealthStatus | String | 否 | Healthy | ECS實(shí)例或ECI實(shí)例在伸縮組中的健康狀態(tài)。未處于運(yùn)行中(Running)狀態(tài)的ECS實(shí)例或ECI實(shí)例會(huì)被判定為不健康的實(shí)例,取值范圍:
彈性伸縮會(huì)自動(dòng)移出伸縮組中不健康的ECS實(shí)例或ECI實(shí)例,并釋放自動(dòng)創(chuàng)建的ECS實(shí)例或ECI實(shí)例。 是否釋放手動(dòng)添加的ECS實(shí)例或ECI實(shí)例由其托管狀態(tài)決定。如果實(shí)例生命周期未托管給伸縮組,只移出實(shí)例但不釋放。如果實(shí)例生命周期托管給伸縮組,移出并釋放實(shí)例。 說明 請(qǐng)確保賬號(hào)可用額度充足。如果賬號(hào)欠費(fèi),所有后付費(fèi)的ECS實(shí)例或ECI實(shí)例(包括按量付費(fèi)實(shí)例和搶占式實(shí)例)都會(huì)停機(jī),甚至被釋放。欠費(fèi)后伸縮組內(nèi)ECS實(shí)例或ECI實(shí)例狀態(tài)變化,請(qǐng)參見欠費(fèi)說明。 |
LifecycleState | String | 否 | InService | ECS實(shí)例、ECI實(shí)例或托管實(shí)例在伸縮組中的生命周期狀態(tài),取值范圍:
|
CreationType | String | 否 | AutoCreated | 伸縮組中實(shí)例的創(chuàng)建方式,取值范圍:
|
PageNumber | Integer | 否 | 1 | 實(shí)例列表的頁碼,起始值:1。 默認(rèn)值:1。 |
PageSize | Integer | 否 | 10 | 分頁查詢時(shí)設(shè)置的每頁行數(shù),最大值:100。 默認(rèn)值:10。 |
ScalingActivityId | String | 否 | asa-bp1c9djwrgxjyk31**** | 伸縮活動(dòng)的ID。 |
InstanceId.N | String | 否 | i-bp109k5j3dum1ce6**** | 伸縮組中實(shí)例的ID,N的取值范圍:1~20。 返回查詢結(jié)果時(shí)忽略失效的InstanceId,并且不報(bào)錯(cuò)。 |
CreationTypes.N | String | 否 | AutoCreated | 伸縮組中實(shí)例的創(chuàng)建方式,此參數(shù)和CreationType參數(shù)不能同時(shí)設(shè)置。取值范圍:
|
LifecycleStates.N | String | 否 | InService | ECS實(shí)例、ECI實(shí)例或托管實(shí)例在伸縮組中的生命周期狀態(tài),取值范圍:
|
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | B13527BF-1FBD-4334-A512-20F5E9D3**** | 請(qǐng)求ID。 |
PageSize | Integer | 10 | 每頁行數(shù)。 |
PageNumber | Integer | 1 | 當(dāng)前頁碼。 |
TotalSpotCount | Integer | 4 | 當(dāng)前伸縮組中,運(yùn)行狀態(tài)的搶占式實(shí)例總數(shù)。 |
TotalCount | Integer | 1 | 實(shí)例的總數(shù)。 |
ScalingInstances | Array of ScalingInstance | 實(shí)例信息組成的集合。 |
|
ScalingInstance | |||
CreationTime | String | 2020-05-18T03:11Z | 實(shí)例加入伸縮組的時(shí)間,精確到分鐘。 |
LoadBalancerWeight | Integer | 50 | 負(fù)載均衡實(shí)例權(quán)重。 說明 該參數(shù)已廢棄,不建議使用。 |
LaunchTemplateId | String | lt-m5e3ofjr1zn1aw7**** | 實(shí)例啟動(dòng)模板的ID。 |
InstanceId | String | i-bp109k5j3dum1ce6**** | 實(shí)例的ID。 |
SpotStrategy | String | SpotWithPriceLimit | 搶占式實(shí)例的搶占策略。可能值:
|
LaunchTemplateVersion | String | 1 | 實(shí)例啟動(dòng)模板的版本。 |
HealthStatus | String | Healthy | ECS實(shí)例或ECI實(shí)例在伸縮組中的健康狀態(tài)。未處于運(yùn)行中(Running)狀態(tài)的ECS實(shí)例或ECI實(shí)例會(huì)被判定為不健康的實(shí)例,可能值:
彈性伸縮會(huì)自動(dòng)移出伸縮組中不健康的ECS實(shí)例或ECI實(shí)例,并釋放自動(dòng)創(chuàng)建的ECS實(shí)例或ECI實(shí)例。 是否釋放手動(dòng)添加的ECS實(shí)例或ECI實(shí)例由其托管狀態(tài)決定。如果實(shí)例生命周期未托管給伸縮組,只移出實(shí)例但不釋放。如果實(shí)例生命周期托管給伸縮組,移出并釋放實(shí)例。 說明 請(qǐng)確保賬號(hào)可用額度充足。如果賬號(hào)欠費(fèi),所有后付費(fèi)的ECS實(shí)例或ECI實(shí)例(包括按量付費(fèi)實(shí)例和搶占式實(shí)例)都會(huì)停機(jī),甚至被釋放。欠費(fèi)后伸縮組內(nèi)ECS實(shí)例或ECI實(shí)例狀態(tài)變化,請(qǐng)參見欠費(fèi)說明。 |
ScalingGroupId | String | asg-bp1igpak5ft1flyp**** | 所屬伸縮組的ID。 |
WarmupState | String | NoNeedWarmup | 實(shí)例的預(yù)熱狀態(tài),可能值:
|
LifecycleState | String | InService | ECS實(shí)例、ECI實(shí)例或托管實(shí)例在伸縮組中的生命周期狀態(tài),可能值:
|
CreationType | String | AutoCreated | 伸縮組中實(shí)例的創(chuàng)建方式,可能值:
|
ZoneId | String | cn-hangzhou-g | 實(shí)例所屬的可用區(qū)ID。 |
ScalingConfigurationId | String | asc-bp1i65jd06v04vdh**** | 關(guān)聯(lián)伸縮配置的ID。 |
Entrusted | Boolean | true | 手動(dòng)添加實(shí)例到伸縮組時(shí),是否將實(shí)例托管給伸縮組,托管狀態(tài)的手動(dòng)添加實(shí)例,在移除伸縮組(不包括手動(dòng)移除)時(shí),將執(zhí)行釋放操作??赡苤担?/p>
|
WeightedCapacity | Integer | 4 | 實(shí)例規(guī)格的權(quán)重,即實(shí)例規(guī)格的單臺(tái)實(shí)例在伸縮組中表示的容量大小。權(quán)重越大,滿足期望容量所需的本實(shí)例規(guī)格的實(shí)例數(shù)量越少。 |
CreatedTime | String | 2020-05-18T03:11:39Z | 實(shí)例加入伸縮組的時(shí)間,精確到秒。 |
ScalingActivityId | String | asa-bp1c9djwrgxjyk31**** | 實(shí)例加入伸縮組時(shí),伸縮活動(dòng)的ID。 |
InstanceType | String | ecs.n1.small | 實(shí)例的規(guī)格。 |
ScalingInstanceId | String | asi-j6cj1gcte640ekhb**** | 伸縮組內(nèi)的實(shí)例標(biāo)識(shí),與ECS實(shí)例或ECI實(shí)例的ID一一對(duì)應(yīng)。 |
PrivateIpAddress | String | 1**.2*.1**.2** | 伸縮組中實(shí)例的內(nèi)網(wǎng)IP地址。 |
示例
請(qǐng)求示例
http(s)://ess.aliyuncs.com/?Action=DescribeScalingInstances
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&ScalingConfigurationId=asc-bp1i65jd06v04vdh****
&HealthStatus=Healthy
&LifecycleState=InService
&CreationType=AutoCreated
&PageNumber=1
&PageSize=10
&ScalingActivityId=asa-bp1c9djwrgxjyk31****
&InstanceId=["i-bp109k5j3dum1ce6****"]
&CreationTypes=["AutoCreated"]
&LifecycleStates=["InService"]
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeScalingInstancesResponse>
<RequestId>B13527BF-1FBD-4334-A512-20F5E9D3****</RequestId>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
<TotalSpotCount>4</TotalSpotCount>
<TotalCount>1</TotalCount>
<ScalingInstances>
<CreationTime>2020-05-18T03:11Z</CreationTime>
<LoadBalancerWeight>50</LoadBalancerWeight>
<LaunchTemplateId>lt-m5e3ofjr1zn1aw7****</LaunchTemplateId>
<InstanceId>i-bp109k5j3dum1ce6****</InstanceId>
<SpotStrategy>SpotWithPriceLimit</SpotStrategy>
<LaunchTemplateVersion>1</LaunchTemplateVersion>
<HealthStatus>Healthy</HealthStatus>
<ScalingGroupId>asg-bp1igpak5ft1flyp****</ScalingGroupId>
<WarmupState>NoNeedWarmup</WarmupState>
<LifecycleState>InService</LifecycleState>
<CreationType>AutoCreated</CreationType>
<ZoneId>cn-hangzhou-g</ZoneId>
<ScalingConfigurationId>asc-bp1i65jd06v04vdh****</ScalingConfigurationId>
<Entrusted>true</Entrusted>
<WeightedCapacity>4</WeightedCapacity>
<CreatedTime>2020-05-18T03:11:39Z</CreatedTime>
<ScalingActivityId>asa-bp1c9djwrgxjyk31****</ScalingActivityId>
<InstanceType>ecs.n1.small</InstanceType>
<ScalingInstanceId>asi-j6cj1gcte640ekhb****</ScalingInstanceId>
<PrivateIpAddress>1**.2*.1**.2**</PrivateIpAddress>
</ScalingInstances>
</DescribeScalingInstancesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/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****",
"InstanceType" : "ecs.n1.small",
"ScalingInstanceId" : "asi-j6cj1gcte640ekhb****",
"PrivateIpAddress" : "1**.2*.1**.2**"
} ]
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。