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实例。

LifecycleStateStringECS实例在伸缩组中的生命周期状态。可选值:

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

错误码

关于所有接口的通用性错误,请参考 客户端错误 或 服务器端错误。

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1611.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注