DescribeScalingInstances

查询伸缩组内ECS实例列表，并列出ECS实例的属性。

描述

您可以通过指定伸缩组ID查询该伸缩组内的ECS实例列表，查询时可以指定伸缩配置ID、健康状态、生命周期状态、创建类型进行过滤。

请求参数


名称	类型	是否必选	描述
Action	String	是	操作接口名，系统规定参数，取值：DescribeScalingInstances。
RegionId	String	是	伸缩组所属的地域ID。
ScalingGroupId	String	否	伸缩组的ID。
ScalingConfigurationId	String	否	关联的伸缩配置ID。
InstanceId.N	String	否	ECS实例的ID。最多可以输入20个。返回查询结果时忽略失效的InstanceId，并且不报错。
HealthStatus	String	否	ECS实例在伸缩组中的健康状态，目前将处于非运行中（`Running`）状态的ECS实例判定为不健康的ECS实例。可选值： Healthy：健康的ECS实例。 Unhealthy：不健康的ECS实例。弹性伸缩会自动移出伸缩组中不健康的ECS实例。对于自动创建的ECS实例，弹性伸缩会停止和释放该ECS实例，对于手工添加的ECS实例，弹性伸缩不会停止和释放该ECS实例。
LifecycleState	String	否	ECS实例在伸缩组中的生命周期状态。可选值： InService：已成功加入伸缩组并正常提供服务。 Pending：正在加入伸缩组但还未完成相关配置，包括创建实例、加入负载均衡、添加RDS访问名单等过程。 Removing：正在移出伸缩组。
CreationType	String	否	ECS实例的创建类型。可选值： AutoCreated：伸缩组根据伸缩配置和伸缩规则自动创建的ECS实例。 Attached：不是通过弹性伸缩服务创建，而是手工添加到伸缩组中的ECS实例。
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实例的创建类型。
WarmupState	String	实例的预热状态。可选值： NoNeedWarmup：不需要预热 WaitingForInstanceWarmup：等待预热结束 InstanceWarmupFinish：预热结束

示例

请求示例

http://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"
      }
    ]
  }
}

错误码

关于所有接口的通用性错误，请参考或。

发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4575.html

描述

请求参数

返回参数

示例

错误码

相关推荐

限制条件

开启实例释放保护

阿里云弹性伸缩怎么自动将伸缩组ECS实例添加到Redis实例白名单？

DescribeNotificationTypes

使用实例启动模板创建伸缩组

什么是弹性伸缩

发表评论