閱讀542 返回首頁    go 英雄聯盟

查詢伸縮組內ECS實例列表__伸縮組相關接口_API參考_彈性伸縮-阿裏雲

描述

查詢伸縮組內ECS實例列表。查詢時可以指定伸縮組ID、伸縮配置ID、健康狀態、生命周期狀態、創建類型進行過濾。

1）加入伸縮組的ECS實例有兩種類型：自動創建的ECS實例、手工添加的ECS實例。

  • “自動創建的ECS實例”是指根據用戶的伸縮配置和伸縮規則，由彈性伸縮服務自動創建的ECS實例。
  • “手工添加的ECS實例”是指不是由彈性伸縮服務創建，但由用戶手工添加到伸縮組中的ECS實例。

2） ECS實例在伸縮組中的生命周期，通過以下幾種狀態描述：

  • Pending – 表示ECS實例正在加入伸縮組，包括創建實例、加入SLB、添加RDS訪問名單等過程。
  • InService – 表示ECS實例已成功加入伸縮組，並正常提供服務。
  • Removing – 表示ECS實例正在移出伸縮組。

3）ECS實例在伸縮組中的健康狀態為：

  • Healthy – 健康
  • Unhealthy – 不健康，本期僅通過ECS實例為非“運行中（Running）”狀態來判斷該實例不健康

4）ESS會自動移出伸縮組中不健康的ECS實例。對於“自動創建的ECS實例”，ESS會停止和釋放該ECS實例。對於“手工添加的ECS實例”，ESS不會停止和釋放該ECS實例。

請求參數

名稱 類型 是否必須 描述
Action String 是 操作接口名，係統規定參數，取值：DescribeScalingInstances。
RegionId String 是 伸縮組所屬的地域ID。
ScalingGroupId String 否 伸縮組的ID。
ScalingConfigurationId String 否 關聯的伸縮配置ID。
InstanceId.N String 否 ECS實例的ID。最多可以輸入20個。返回查詢結果時忽略失效的InstanceId，並且不報錯。
HealthStatus String 否 ECS實例在伸縮中的健康狀態。可選值：Healthy：健康的ECS實例。Unhealthy：不健康的ECS實例。
LifecycleState String 否 ECS實例在伸縮組中的生命周期狀態。可選值：InService：已成功加入伸縮組並正常運行。Pending：正在加入伸縮組還未完成相關配置。Removing：正在移出伸縮組。
CreationType String 否 ECS實例的創建類型。可選值：AutoCreated：由ESS自動在伸縮組中創建。Attached：在ESS之外創建，並由用戶手工加入伸縮組。
PageNumber Integer 否 ECS實例列表的頁碼，起始值為1，默認值為1。
PageSize Integer 否 分頁查詢時設置的每頁行數，最大值50行，默認值為10。

返回參數

名稱 類型 描述
TotalCount Integer ECS實例總數
PageNumber Integer 當前頁碼
PageSize Integer 每頁行數
ScalingInstances ScalingInstanceSetType ECS實例信息組成的集合

ScalingInstanceSetType是由ScalingInstanceItemType類型組成的集合：

名稱 類型 描述
ScalingInstance ScalingInstanceItemType ECS實例信息

ScalingInstanceItemType類型的屬性如下：

名稱 類型 描述
InstanceId String ECS實例的ID。
ScalingGroupId String 所屬的伸縮組的ID。
ScalingConfigurationId String 關聯的伸縮配置ID。
HealthStatus String 在伸縮組中的健康狀態。
LifecycleState String 在伸縮組中的生命周期狀態。
CreationTime String 加入伸縮組的時間。
CreationType String ECS實例的創建類型。

錯誤碼

對於所有接口的通用性錯誤，請參考章節。

示例

請求示例

https://ess.aliyuncs.com/?Action=DescribeScalingInstances 
&RegionId=cn-qingdao
&ScalingGroupId=dBCYxE26IHKcGq1xPcTNBwV
&<公共請求參數>

返回示例

XML示例

<DescribeScalingInstancesResponse>
    <RequestId>DFF8797F-5B73-4BD7-A7D0-03479C458F7A</RequestId>
<TotalCount>1</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <ScalingInstances>
        <ScalingInstance>
            <CreationTime>2014-08-15T17:37Z</CreationTime>
            <CreationType>AutoCreated</CreationType>
            <HealthStatus>Healthy</HealthStatus>
            <InstanceId>i-283vvyytn</InstanceId>
            <LifecycleState>InService</LifecycleState>         <ScalingConfigurationId>
cGsGHrdMBa3DcDrrBVcc4k2H
</ScalingConfigurationId>
            <ScalingGroupId>dBCYxE26IHKcGq1xPcTNBwV</ScalingGroupId>
        </ScalingInstance>
    </ScalingInstances>
</DescribeScalingInstancesResponse>

JSON格式


{
  "RequestId": "13305F2D-A4C2-4E6B-B7C7-0F2150842EA3",
"TotalCount": 1,
"PageNumber": 1,
"PageSize": 50,
  "ScalingInstances": {
    "ScalingInstance": [
      {
        "ScalingConfigurationId": "bU5uZHcAgtzwcL4IeDeavqTS",
        "CreationType": "AutoCreated",
        "InstanceId": "i-28sov3exk",
        "CreationTime": "2014-08-14T10:59Z",
        "HealthStatus": "Healthy",
        "LifecycleState": "InService",
        "ScalingGroupId": "dE9YbOdCHqaFdFZHXVdDjQCB"
      }
    ]
  }
}

最後更新：2016-11-23 16:03:52

  上一篇：go 錯誤結果__返回結果_API參考_彈性伸縮-阿裏雲
  下一篇：go 修改伸縮規則__伸縮規則相關接口_API參考_彈性伸縮-阿裏雲