全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
弹性伸缩

查询伸缩组

更新时间:2017-06-07 13:26:11

描述

查询伸缩组的信息。伸缩组具有以下几种状态(LifecycleState):

  • Active:生效状态,在该状态下才能接收执行伸缩规则的请求并触发伸缩活动。
  • Inacitve:失效状态,在该状态下不接收任何执行伸缩规则的请求。
  • Deleting:伸缩组正在删除,在该状态下不接收任何执行伸缩规则的请求。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:DescribeScalingGroups。
RegionId String 伸缩组所属的地域 ID。
ScalingGroupId.N String 伸缩组的 ID,最多可以输入 20 个。查询结果会忽略失效的伸缩组 ID,并且不报错。
ScalingGroupName.N String 伸缩组的名称,最多可以输入 20 个。查询结果会忽略失效的伸缩组名称,并且不报错。
PageNumber Integer 伸缩组列表的页码,起始值为 1,默认值为 1。
PageSize Integer 分页查询时设置的每页行数,最大值 50 行,默认值为10。

返回参数

名称 类型 描述
TotalCount Integer 伸缩组的总数
PageNumber Integer 当前页码
PageSize Integer 每页行数
ScalingGroups ScalingGroupSetType 伸缩组信息的集合

ScalingGroupSetType 是由 ScalingGroupItemType 类型组成的集合:

名称 类型 描述
ScalingGroup ScalingGroupItemType 伸缩组信息

ScalingGroupItemType 类型的属性如下:

名称 类型 描述
ScalingGroupId String 伸缩组的 ID。
ScalingGroupName String 伸缩组的显示名称。
ActiveScalingConfigurationId String 伸缩组内生效的伸缩配置 ID。
RegionId String 伸缩组所属的地域 ID。
MinSize Integer 伸缩组内 ECS 实例个数的最小值。
MaxSize Integer 伸缩组内 ECS 实例个数的最大值。
DefaultCooldown Integer 伸缩组默认的冷却时间。
RemovalPolicies RemovalPolicySetType ECS 实例移出伸缩组的策略的集合。
LoadBalancerId String 负载均衡实例的 ID。
DBInstanceIds DBInstanceIdSetType RDS 实例 ID 的集合。
VSwitchId String 伸缩组对应虚拟交换机的 ID。
LifecycleState String 伸缩组的状态信息。
TotalCapacity Integer 伸缩组内所有 ECS 实例的数量。
ActiveCapacity Integer 已成功加入伸缩组,并正常运行的 ECS 实例数量。
PendingCapacity Integer 正在加入伸缩组,还未完成相关配置的 ECS 实例数量。
RemovingCapacity Integer 正在移出伸缩组的 ECS 实例数。量。
CreationTime String 伸缩组的创建时间。

RemovalPolicySetType 是由 String 类型组成的集合:

名称 类型 描述
RemovalPolicy String ECS 实例移出伸缩组的策略。

DBInstanceIdSetType 是由 String 类型组成的集合:

名称 类型 描述
DBInstanceId String RDS 实例的 ID

错误码

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

示例

请求示例

  1. http://ess.aliyuncs.com/?Action=DescribeScalingGroups
  2. &RegionId=cn-qingdao
  3. &PageSize=50
  4. &<公共请求参数>

返回示例

XML格式:

  1. <DescribeScalingGroupsResponse>
  2. <RequestId>6393C3A8-B611-42F2-AFA6-F080FC45D5D0</RequestId>
  3. <TotalCount>1</TotalCount>
  4. <PageNumber>1</PageNumber>
  5. <PageSize>10</PageSize>
  6. <ScalingGroups>
  7. <ScalingGroup>
  8. <ActiveCapacity>1</ActiveCapacity> <ActiveScalingConfigurationId>
  9. dyo713cNYIB4ddEVlKbcpOef
  10. </ActiveScalingConfigurationId>
  11. <DBInstanceIds>
  12. <DBInstanceId>rdszzzyyunybaeu</DBInstanceId>
  13. </DBInstanceIds>
  14. <VSwitchId>vpc-25j4god4l</VSwitchId>
  15. <DefaultCooldown>20</DefaultCooldown>
  16. <LifecycleState>Active</LifecycleState>
  17. <LoadBalancerId>147b46d767c-cn-qingdao-cm5-a01</LoadBalancerId>
  18. <MaxSize>1</MaxSize>
  19. <MinSize>0</MinSize>
  20. <PendingCapacity>0</PendingCapacity>
  21. <RegionId>cn-qingdao</RegionId>
  22. <RemovingCapacity>0</RemovingCapacity>
  23. <ScalingGroupId>dyrSuvBOtO1dEdIlIbplQb8</ScalingGroupId>
  24. <ScalingGroupName>dyrSuvBOtO1dEdIlIbplQb8</ScalingGroupName>
  25. <RemovalPolicies>
  26. <RemovalPolicy>OldestScalingConfiguration</RemovalPolicy>
  27. <RemovalPolicy>OldestInstance</RemovalPolicy>
  28. </RemovalPolicies>
  29. <TotalCapacity>1</TotalCapacity>
  30. <CreationTime>2014-08-14T10:58Z</CreationTime>
  31. </ScalingGroup>
  32. </ScalingGroups>
  33. </DescribeScalingGroupsResponse>

JSON格式:

  1. {
  2. "RequestId": "68386699-8B9E-4D5B-BC4C-75A28F6C2A00",
  3. "TotalCount": 1,
  4. "PageSize": 10,
  5. "PageNumber": 1,
  6. "ScalingGroups": {
  7. "ScalingGroup": [
  8. {
  9. "ScalingGroupId": "b8pYCVbIV5k9cz4PWpbe0k19",
  10. "ScalingGroupName": "b8pYCVbIV5k9cz4PWpbe0k19",
  11. "RegionId": "cn-qingdao",
  12. "RemovingCapacity": 0,
  13. "DefaultCooldown": 300,
  14. "MinSize": 1,
  15. "MaxSize": 2,
  16. "LifecycleState": "Inactive",
  17. "ActiveScalingConfigurationId": " dyo713cNYIB4ddEVlKbcpOef",
  18. "LoadBalancerId": "147b46d767c-cn-qingdao-cm5-a01",
  19. "PendingCapacity": 0,
  20. "TotalCapacity": 0,
  21. "ActiveCapacity": 0,
  22. "CreationTime": "2014-08-14T10:58Z",
  23. "DBInstanceIds": {
  24. "DBInstanceId": [
  25. "rdsia3u3yia3u3y",
  26. "rdszzzyyunybaeu"
  27. ]
  28. },
  29. "VSwitchId":"vpc-25j4god4l",
  30. "RemovalPolicies": {
  31. "RemovalPolicy": [
  32. "OldestScalingConfiguration",
  33. "OldestInstance"
  34. ]
  35. }
  36. }
  37. ]
  38. }
  39. }
本文导读目录