阿里云如何使用查询实例状态接口

　　查询实例状态

　　描述

　　批量获取当前用户所有实例的状态信息，也可用于获取实例列表，详见实例状态表;

　　借助 RAM 实现授权访问资源操作时的特殊限制

　　只允许查询前 100 个实例的状态;如果 PageNumber、PageSize 组合出的值超过了此限制，请求会被拒绝，错误码为：Forbidden.AccessTooManyOthersResource。

　　Response中，TotalCount 表示：ResourceOwner 的所有实例中，有多少实例被授予了调用者进行该操作。当个数超过 100 个时，TotalCount 取值为 100。

　　请求参数

名称 类型 是否必须 描述
Action   String   是   操作接口名，系统规定参数，取值：DescribeInstanceStatus  
RegionId   String   是   实例所属于的 Region ID  
ZoneId   String   否   实例所属可用区  
PageNumber   Integer   否   实例状态列表的页码，起始值为 1，默认值为 1  
PageSize   Integer   否   分页查询时设置的每页行数，最大值 50 行，默认值为 10  

　　返回参数

名称 类型 描述
TotalCount   Integer   实例总个数  
PageNumber   Integer   实例列表的页码  
PageSize   Integer   输入时设置的每页行数  
InstanceStatuses   InstanceStatusSetType   由 InstanceStatusItemType 组成的数组格式，返回实例的状态信息  

　　错误码

错误代码 描述 Http 状态码 语义
MissingParameter   The input parameter "RegionId" that is mandatory for processing this request is not supplied.   400   缺少 RegionId 值  
InvalidParameter   The specified parameter "PageNumber" is not valid.   400   指定的 PageNumber 不合法（不是数字）  
InvalidParameter   The specified parameter "PageSize" is not valid.   400   指定的 PageSize 不合法（不是数字或超出范围）  

　　示例

　　请求示例

　　https://ecs.aliyuncs.com/?Action=DescribeInstanceStatus

　　&RegionId=cn-hangzhou

　　&<公共请求参数>

　　返回示例

　　XML格式

　　

　　6EF60BEC-0242-43AF-BB20-270359FB54A7

　　2

　　1

　　10

　　

　　

　　i-instance1

　　Running

　　

　　

　　i-ae4r89pp

　　Stopped

　　

　　

　　

　　JSON格式

　　{

　　"RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7",

　　"TotalCount": 2,

　　"PageNumber": 1,

　　"PageSize": 10,

　　"InstanceStatuses": {

　　"InstanceStatus": [{

　　"InstanceId": "i-instance1",

　　"Status": "Running"

　　},

　　{

　　"InstanceId": "i-ae4r89pp",

　　"Status": "Stopped"