查詢可用鏡像

　　描述

　　查詢用戶可以使用的鏡像列表。顯示出的鏡像資源列表包括用戶自己私有的鏡像，阿里云提供系統資源，其他公共的鏡像資源和鏡像市場的鏡像，鏡像市場的鏡像需要先到鏡像市場的網站上訂閱后才能進行創建云服務器實例。此接口支持分頁查詢，查詢結果包括可使用的鏡像資源的總數和當前頁的鏡像資源。每頁的數量默認為 10 條。

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   系統規定參數，取值：DescribeImages  
RegionId   String   是   實例所屬于的 Region ID  
ImageId   String   否   鏡像 ID，最多 100 個Id，用半角逗號字符隔開。  
Status   String   否   鏡像狀態，
取值：

UnAvailable | Available | Creating | CreateFailed

默認值：Available
取值說明：

Creating 創建中

Available 可用

UnAvailable 不可用

CreateFailed 創建失敗

 
SnapshotId   String   否   創建鏡像的快照 ID  
ImageName   String   否   鏡像的名稱  
ImageOwnerAlias   string   否   鏡像所有者別名。
取值：

system | self | others | marketplace

默認值：無，表示返回 system + self + others
不設置該參數說明不使用該參數進行過濾條件
取值說明：

system 阿里云官方提供鏡像

self 用戶自定義鏡像

others 非自己的可用鏡像

marketplace 鏡像市場提供的鏡像

 
Usage   String   否   有引用關系的資源類型，instance | none  
Tag.n.Key   String   否   標簽 key，n 從 1 開始，最大為 5。
不允許為空字符串。  
Tag.n.Value   String   否   標簽 value，n 從 1 開始，最大為 5。
允許為空字符串。  
PageNumber   Integer   否   實例狀態列表的頁碼，起始值為 1，默認值為 1  
PageSize   Integer   否   分頁查詢時設置的每頁行數，最大值 100 行，默認值為 10  

　　返回參數

名稱 類型 描述
RegionId   String   鏡像所屬地域 Id  
TotalCount   Integer   列表條條目數  
PageNumber   Integer   當前頁碼  
PageSize   Integer   當前分頁包含多少條目  
Images   ImageType   鏡像信息 ImageType 組成的集合  

　　錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
MissingParameter   The input parameter "RegionId" that is mandatory for processing this request is not supplied.   400   缺少 RegionId 字段  
InvalidImageOwnerAlias.ValueNotSupported   The specified ImageOwnerAlias value is not supported.   400   無效的 ImageOwnerAlias 取值  
InvalidParameter   The specified parameter "PageNumber" is not valid.   400   指定的 PageNumber 不合法  
InvalidParameter   The specified parameter "PageSize" is not valid.   400   指定的 PageSize 不合法  
InvalidUsage   The specifed Usage is not valid   404   指定的 Usage 不合法  

　　示例

　　請求示例

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

　　&RegionId=cn-hangzhou

　　&<公共請求參數>

　　返回示例

　　JSON格式

　　{

　　"Images": {

　　"Image": [

　　{

　　"Architecture": "x86_64",

　　"CreationTime": "2015-05-06T09:01:32Z",

　　"DiskDeviceMappings": {

　　"DiskDeviceMapping": [

　　{

　　"Device": "/dev/xvda",

　　"Size": "20"

　　}

　　]

　　},

　　"ImageId": "suse11sp3_64_20G_aliaegis_20150428.vhd",

　　"ImageName": "suse11sp3_64_20G_aliaegis_20150428.vhd",

　　"ImageOwnerAlias": "system",

　　"ImageVersion": "1",

　　"IsCopied": false,

　　"IsSubscribed": false,

　　"OSName": "SUSE Linux Enterprise Server 11 SP3 64位",

　　"OSType": "linux",

　　"Platform": "SUSE",

　　"Progress": "100%",

　　"Size": 20,

　　"Status": "Available",

　　"Usage": "instance"

　　}

　　]

　　}

　　"PageNumber": 1,

　　"PageSize": 1,

　　"RegionId": "cn-hangzhou",

　　"RequestId": "49CBCED4-C9B9-4851-BEB5-8FB5E5169E30",

　　"TotalCount": 24