查詢實例狀態

　　描述

　　批量獲取當前用戶所有實例的狀態信息，也可用于獲取實例列表，詳見實例狀態表;

　　借助 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"