全部產品
Search

搜尋本產品

    Auto Scaling：DescribeScalingInstances

    文件中心

    Auto Scaling：DescribeScalingInstances

    更新時間：Jun 30, 2025

    調用DescribeScalingInstances，通過伸縮組ID查詢該伸縮組內的ECS執行個體列表及執行個體資訊，包括當前伸縮組中，運行狀態的搶佔式執行個體總數、ECS執行個體總數、ECS執行個體的預熱狀態、生命週期狀態等。同時也支援指定執行個體健康狀態、生命週期狀態、建立方式等篩選符合要求的ECS執行個體。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    請求參數

    名稱

    類型

    是否必選

    樣本值

    描述
    Action String 是 DescribeScalingInstances

    系統規定參數。取值：DescribeScalingInstances。
    RegionId String 是 cn-hangzhou

    伸縮組所屬地區的ID。
    ScalingGroupId String 否 asg-bp1igpak5ft1flyp****

    伸縮組的ID。
    ScalingConfigurationId String 否 asc-bp1i65jd06v04vdh****

    關聯伸縮配置的ID。
    HealthStatus String 否 Healthy

    ECS執行個體或ECI執行個體在伸縮組中的健康狀態。未處於運行中（Running）狀態的ECS執行個體或ECI執行個體會被判定為不健康的執行個體，取值範圍：

    • Healthy：健康的ECS執行個體或ECI執行個體。
    • Unhealthy：不健康的ECS執行個體或ECI執行個體。

    Auto Scaling會自動移出伸縮組中不健康的ECS執行個體或ECI執行個體，並釋放自動建立的ECS執行個體或ECI執行個體。

    是否釋放手動添加的ECS執行個體或ECI執行個體由其託管狀態決定。如果執行個體生命週期未託管給伸縮組，只移出執行個體但不釋放。如果執行個體生命週期託管給伸縮組，移出並釋放執行個體。

    說明 請確保帳號可用額度充足。如果帳號欠費，所有後付費的ECS執行個體或ECI執行個體（包括隨用隨付執行個體和搶佔式執行個體）都會停機，甚至被釋放。欠費後伸縮組內ECS執行個體或ECI執行個體狀態變化，請參見欠費說明。
    LifecycleState String 否 InService

    ECS執行個體、ECI執行個體或受管理的執行個體在伸縮組中的生命週期狀態，取值範圍：

    • InService：已成功加入伸縮組並正常提供服務。
    • Pending：加入中。ECS執行個體或ECI執行個體加入伸縮組時包括加入Server Load Balancer執行個體的後端伺服器、RDS執行個體的訪問白名單等過程。
    • Pending:Wait：加入掛起中。如果伸縮組內建立了適用於彈性擴張活動的生命週期掛鈎，ECS執行個體或ECI執行個體在加入伸縮組時被掛起並等待掛鈎逾時時間結束。
    • Protected：保護中。ECS執行個體或ECI執行個體正常提供服務，但Auto Scaling不管理ECS執行個體或ECI執行個體的生命週期，而是由您手動管理。
    • Standby：備用中。ECS執行個體或ECI執行個體不提供服務，負載平衡權重被置為零，且Auto Scaling不管理ECS執行個體的生命週期，而是由您手動管理。
    • Stopped：停用中。ECS執行個體、ECI執行個體或受管理的執行個體已停機，不提供服務。
    • Removing：移出中。ECS執行個體或ECI執行個體移出伸縮組時包括移出Server Load Balancer執行個體的後端伺服器、RDS執行個體的訪問白名單等過程。

    • Removing:Wait：移出掛起中。如果伸縮組內建立了適用於彈性收縮活動的生命週期掛鈎，ECS執行個體或ECI執行個體在移出伸縮組時被掛起並等待掛鈎逾時時間結束。

      說明 受管理的執行個體不支援配置生命週期掛鈎、關聯到負載平衡和健全狀態檢查功能。
    CreationType String 否 AutoCreated

    伸縮組中執行個體的建立方式，取值範圍：

    • AutoCreated：Auto Scaling根據執行個體配置資訊來源自動建立的ECS執行個體或ECI執行個體。
    • Attached：不是通過Auto Scaling服務建立，而是由您手動添加到伸縮組中的ECS執行個體或ECI執行個體。
    • Managed：不是通過Auto Scaling服務建立，而是由您手動添加到伸縮組中的受管理的執行個體。
    PageNumber Integer 否 1

    執行個體列表的頁碼，起始值：1。

    預設值：1。
    PageSize Integer 否 10

    分頁查詢時設定的每頁行數，最大值：100。

    預設值：10。
    ScalingActivityId String 否 asa-bp1c9djwrgxjyk31****

    伸縮活動的ID。
    InstanceId.N String 否 i-bp109k5j3dum1ce6****

    伸縮組中執行個體的ID，N的取值範圍：1～20。

    返回查詢結果時忽略失效的InstanceId，並且不報錯。
    CreationTypes.N String 否 AutoCreated

    伸縮組中執行個體的建立方式，此參數和CreationType參數不能同時設定。取值範圍：

    • AutoCreated：Auto Scaling根據執行個體配置資訊來源自動建立的ECS執行個體。
    • Attached：不是通過Auto Scaling服務建立，而是由您手動添加到伸縮組中的ECS執行個體。

    • Managed：不是通過Auto Scaling服務建立，而是由您手動添加到伸縮組中的受管理的執行個體。

      說明 設定該參數時，您可以選擇多個建立方式（例如取值為AutoCreated、Attached、Managed）。
    LifecycleStates.N String 否 InService

    ECS執行個體、ECI執行個體或受管理的執行個體在伸縮組中的生命週期狀態，取值範圍：

    • InService：已成功加入伸縮組並正常提供服務。
    • Pending：加入中。ECS執行個體或ECI執行個體加入伸縮組時包括加入Server Load Balancer執行個體的後端伺服器、RDS執行個體的訪問白名單等過程。
    • Pending:Wait：加入掛起中。如果伸縮組內建立了適用於彈性擴張活動的生命週期掛鈎，ECS執行個體或ECI執行個體在加入伸縮組時被掛起並等待掛鈎逾時時間結束。
    • Protected：保護中。ECS執行個體或ECI執行個體正常提供服務，但Auto Scaling不管理ECS執行個體或ECI執行個體的生命週期，而是由您手動管理。
    • Standby：備用中。ECS執行個體或ECI執行個體不提供服務，負載平衡權重被置為零，且Auto Scaling不管理ECS執行個體的生命週期，而是由您手動管理。
    • Stopped：停用中。ECS執行個體、ECI執行個體或受管理的執行個體已停機，不提供服務。
    • Removing：移出中。ECS執行個體或ECI執行個體移出伸縮組時包括移出Server Load Balancer執行個體的後端伺服器、RDS執行個體的訪問白名單等過程。

    • Removing:Wait：移出掛起中。移出掛起中。如果伸縮組內建立了適用於彈性收縮活動的生命週期掛鈎，ECS執行個體或ECI執行個體在移出伸縮組時被掛起並等待掛鈎逾時時間結束。

      說明 受管理的執行個體不支援配置生命週期掛鈎、關聯到負載平衡和健全狀態檢查功能。

    返回資料

    名稱

    類型

    樣本值

    描述
    RequestId String B13527BF-1FBD-4334-A512-20F5E9D3****

    請求ID。
    PageSize Integer 10

    每頁行數。
    PageNumber Integer 1

    當前頁碼。
    TotalSpotCount Integer 4

    當前伸縮組中，運行狀態的搶佔式執行個體總數。
    TotalCount Integer 1

    執行個體的總數。
    ScalingInstances Array of ScalingInstance

    執行個體資訊組成的集合。
    ScalingInstance
    CreationTime String 2020-05-18T03:11Z

    執行個體加入伸縮組的時間，精確到分鐘。
    LoadBalancerWeight Integer 50

    Server Load Balancer執行個體權重。

    說明 該參數已廢棄，不建議使用。
    LaunchTemplateId String lt-m5e3ofjr1zn1aw7****

    執行個體啟動模板的ID。
    InstanceId String i-bp109k5j3dum1ce6****

    執行個體的ID。
    SpotStrategy String SpotWithPriceLimit

    搶佔式執行個體的搶佔策略。可能值：

    • SpotWithPriceLimit：設定上限價格的搶佔式執行個體。
    • SpotAsPriceGo：系統自動出價，跟隨當前市場實際價格。
    LaunchTemplateVersion String 1

    執行個體啟動模板的版本。
    HealthStatus String Healthy

    ECS執行個體或ECI執行個體在伸縮組中的健康狀態。未處於運行中（Running）狀態的ECS執行個體或ECI執行個體會被判定為不健康的執行個體，可能值：

    • Healthy：健康的ECS執行個體或ECI執行個體。
    • Unhealthy：不健康的ECS執行個體或ECI執行個體。

    Auto Scaling會自動移出伸縮組中不健康的ECS執行個體或ECI執行個體，並釋放自動建立的ECS執行個體或ECI執行個體。

    是否釋放手動添加的ECS執行個體或ECI執行個體由其託管狀態決定。如果執行個體生命週期未託管給伸縮組，只移出執行個體但不釋放。如果執行個體生命週期託管給伸縮組，移出並釋放執行個體。

    說明 請確保帳號可用額度充足。如果帳號欠費，所有後付費的ECS執行個體或ECI執行個體（包括隨用隨付執行個體和搶佔式執行個體）都會停機，甚至被釋放。欠費後伸縮組內ECS執行個體或ECI執行個體狀態變化，請參見欠費說明。
    ScalingGroupId String asg-bp1igpak5ft1flyp****

    所屬伸縮組的ID。
    WarmupState String NoNeedWarmup

    執行個體的預熱狀態，可能值：

    • NoNeedWarmup：不需要預熱。
    • WaitingForInstanceWarmup：等待預熱結束。
    • InstanceWarmupFinish：預熱結束。
    LifecycleState String InService

    ECS執行個體、ECI執行個體或受管理的執行個體在伸縮組中的生命週期狀態，可能值：

    • InService：已成功加入伸縮組並正常提供服務。
    • Pending：加入中。ECS執行個體或ECI執行個體加入伸縮組時包括加入Server Load Balancer執行個體的後端伺服器、RDS執行個體的訪問白名單等過程。
    • Pending:Wait：加入掛起中。如果伸縮組內建立了適用於彈性擴張活動的生命週期掛鈎，ECS執行個體或ECI執行個體在加入伸縮組時被掛起並等待掛鈎逾時時間結束。
    • Protected：保護中。ECS執行個體或ECI執行個體正常提供服務，但Auto Scaling不管理ECS執行個體或ECI執行個體的生命週期，而是由您手動管理。
    • Standby：備用中。ECS執行個體或ECI執行個體不提供服務，負載平衡權重被置為零，且Auto Scaling不管理ECS執行個體的生命週期，而是由您手動管理。
    • Stopped：停用中。ECS執行個體、ECI執行個體或受管理的執行個體已停機，不提供服務。
    • Removing：移出中。ECS執行個體或ECI執行個體移出伸縮組時包括移出Server Load Balancer執行個體的後端伺服器、RDS執行個體的訪問白名單等過程。

    • Removing:Wait：移出掛起中。如果伸縮組內建立了適用於彈性收縮活動的生命週期掛鈎，ECS執行個體或ECI執行個體在移出伸縮組時被掛起並等待掛鈎逾時時間結束。

      說明 受管理的執行個體不支援配置生命週期掛鈎、關聯到負載平衡和健全狀態檢查功能。
    CreationType String AutoCreated

    伸縮組中執行個體的建立方式，可能值：

    • AutoCreated：Auto Scaling根據執行個體配置資訊來源自動建立的ECS執行個體。
    • Attached：不是通過Auto Scaling服務建立，而是由您手動添加到伸縮組中的ECS執行個體。
    • Managed：不是通過Auto Scaling服務建立，而是由您手動添加到伸縮組中的受管理的執行個體。
    ZoneId String cn-hangzhou-g

    執行個體所屬的可用性區域ID。
    ScalingConfigurationId String asc-bp1i65jd06v04vdh****

    關聯伸縮配置的ID。
    Entrusted Boolean true

    手動添加執行個體到伸縮組時，是否將執行個體託管給伸縮組，託管狀態的手動添加執行個體，在移除伸縮組（不包括手動移除）時，將執行釋放操作。可能值：

    • true：將執行個體託管給伸縮組。
    • false：不將執行個體託管給伸縮組。
    WeightedCapacity Integer 4

    執行個體規格的權重，即執行個體規格的單台執行個體在伸縮組中表示的容量大小。權重越大，滿足期望容量所需的本執行個體規格的執行個體數量越少。
    CreatedTime String 2020-05-18T03:11:39Z

    執行個體加入伸縮組的時間，精確到秒。
    ScalingActivityId String asa-bp1c9djwrgxjyk31****

    執行個體加入伸縮組時，伸縮活動的ID。
    InstanceType String ecs.n1.small

    執行個體的規格。
    ScalingInstanceId String asi-j6cj1gcte640ekhb****

    伸縮組內的執行個體標識，與ECS執行個體或ECI執行個體的ID一一對應。
    PrivateIpAddress String 1**.2*.1**.2**

    伸縮組中執行個體的內網IP地址。

    樣本

    請求樣本

    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"]
&公用請求參數

    正常返回樣本

    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**"
  } ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。