伸缩组：查询伸缩组
描述
查询伸缩组的信息。伸缩组具有以下几种状态（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 实例移出伸缩组的策略的集合。 |
| LoadBalancerIds | List of LoadBalancerId | 负载均衡实例的 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 |
错误码
关于所有接口的通用性错误，请参考 客户端错误表或 服务器端错误表。
示例
请求示例
http://ess.aliyuncs.com/?Action=DescribeScalingGroups
&RegionId=cn-qingdao
&PageSize=50
&<公共请求参数>
返回示例
XML格式：
<DescribeScalingGroupsResponse>
<RequestId>6393C3A8-B611-42F2-AFA6-F080FC45D5D0</RequestId>
<TotalCount>1</TotalCount>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<ScalingGroups>
<ScalingGroup>
<ActiveCapacity>1</ActiveCapacity> <ActiveScalingConfigurationId>
dyo713cNYIB4ddEVlKbcpOef
</ActiveScalingConfigurationId>
<DBInstanceIds>
<DBInstanceId>rdszzzyyunybaeu</DBInstanceId>
</DBInstanceIds>
<VSwitchId>vpc-25j4god4l</VSwitchId>
<DefaultCooldown>20</DefaultCooldown>
<LifecycleState>Active</LifecycleState>
<LoadBalancerId>147b46d767c-cn-qingdao-cm5-a01</LoadBalancerId>
<MaxSize>1</MaxSize>
<MinSize>0</MinSize>
<PendingCapacity>0</PendingCapacity>
<RegionId>cn-qingdao</RegionId>
<RemovingCapacity>0</RemovingCapacity>
<ScalingGroupId>dyrSuvBOtO1dEdIlIbplQb8</ScalingGroupId>
<ScalingGroupName>dyrSuvBOtO1dEdIlIbplQb8</ScalingGroupName>
<RemovalPolicies>
<RemovalPolicy>OldestScalingConfiguration</RemovalPolicy>
<RemovalPolicy>OldestInstance</RemovalPolicy>
</RemovalPolicies>
<TotalCapacity>1</TotalCapacity>
<CreationTime>2014-08-14T10:58Z</CreationTime>
</ScalingGroup>
</ScalingGroups>
</DescribeScalingGroupsResponse>
JSON格式：
{
"RequestId": "68386699-8B9E-4D5B-BC4C-75A28F6C2A00",
"TotalCount": 1,
"PageSize": 10,
"PageNumber": 1,
"ScalingGroups": {
"ScalingGroup": [
{
"ScalingGroupId": "b8pYCVbIV5k9cz4PWpbe0k19",
"ScalingGroupName": "b8pYCVbIV5k9cz4PWpbe0k19",
"RegionId": "cn-qingdao",
"RemovingCapacity": 0,
"DefaultCooldown": 300,
"MinSize": 1,
"MaxSize": 2,
"LifecycleState": "Inactive",
"ActiveScalingConfigurationId": " dyo713cNYIB4ddEVlKbcpOef",
"LoadBalancerId": "147b46d767c-cn-qingdao-cm5-a01",
"PendingCapacity": 0,
"TotalCapacity": 0,
"ActiveCapacity": 0,
"CreationTime": "2014-08-14T10:58Z",
"DBInstanceIds": {
"DBInstanceId": [
"rdsia3u3yia3u3y",
"rdszzzyyunybaeu"
]
},
"VSwitchId":"vpc-25j4god4l",
"RemovalPolicies": {
"RemovalPolicy": [
"OldestScalingConfiguration",
"OldestInstance"
]
}
}
]
}
}
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
