阿里云如何使用查詢實(shí)例狀態(tài)接口

　　查詢實(shí)例狀態(tài)

　　描述

　　批量獲取當(dāng)前用戶所有實(shí)例的狀態(tài)信息，也可用于獲取實(shí)例列表，詳見(jiàn)實(shí)例狀態(tài)表;

　　借助 RAM 實(shí)現(xiàn)授權(quán)訪問(wèn)資源操作時(shí)的特殊限制

　　只允許查詢前 100 個(gè)實(shí)例的狀態(tài);如果 PageNumber、PageSize 組合出的值超過(guò)了此限制，請(qǐng)求會(huì)被拒絕，錯(cuò)誤碼為：Forbidden.AccessTooManyOthersResource。

　　Response中，TotalCount 表示：ResourceOwner 的所有實(shí)例中，有多少實(shí)例被授予了調(diào)用者進(jìn)行該操作。當(dāng)個(gè)數(shù)超過(guò) 100 個(gè)時(shí)，TotalCount 取值為 100。

　　請(qǐng)求參數(shù)

名稱 類型 是否必須 描述
Action   String   是   操作接口名，系統(tǒng)規(guī)定參數(shù)，取值：DescribeInstanceStatus  
RegionId   String   是   實(shí)例所屬于的 Region ID  
ZoneId   String   否   實(shí)例所屬可用區(qū)  
PageNumber   Integer   否   實(shí)例狀態(tài)列表的頁(yè)碼，起始值為 1，默認(rèn)值為 1  
PageSize   Integer   否   分頁(yè)查詢時(shí)設(shè)置的每頁(yè)行數(shù)，最大值 50 行，默認(rèn)值為 10  

　　返回參數(shù)

名稱 類型 描述
TotalCount   Integer   實(shí)例總個(gè)數(shù)  
PageNumber   Integer   實(shí)例列表的頁(yè)碼  
PageSize   Integer   輸入時(shí)設(shè)置的每頁(yè)行數(shù)  
InstanceStatuses   InstanceStatusSetType   由 InstanceStatusItemType 組成的數(shù)組格式，返回實(shí)例的狀態(tài)信息  

　　錯(cuò)誤碼

錯(cuò)誤代碼 描述 Http 狀態(tài)碼 語(yǔ)義
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 不合法（不是數(shù)字）  
InvalidParameter   The specified parameter "PageSize" is not valid.   400   指定的 PageSize 不合法（不是數(shù)字或超出范圍）  

　　示例

　　請(qǐng)求示例

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

　　&RegionId=cn-hangzhou

　　&<公共請(qǐng)求參數(shù)>

　　返回示例

　　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"