阿里云如何使用鏡像相關(guān)接口

　　查詢可用鏡像

　　描述

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

　　請求參數(shù)

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

UnAvailable | Available | Creating | CreateFailed

默認(rèn)值：Available
取值說明：

Creating 創(chuàng)建中

Available 可用

UnAvailable 不可用

CreateFailed 創(chuàng)建失敗

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

system | self | others | marketplace

默認(rèn)值：無，表示返回 system + self + others
不設(shè)置該參數(shù)說明不使用該參數(shù)進(jìn)行過濾條件
取值說明：

system 阿里云官方提供鏡像

self 用戶自定義鏡像

others 非自己的可用鏡像

marketplace 鏡像市場提供的鏡像

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

　　返回參數(shù)

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

　　錯誤碼

錯誤代碼 描述 Http 狀態(tài)碼 語義
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

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

　　返回示例

　　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