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

　　查詢可用鏡像

　　描述

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

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

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

UnAvailable | Available | Creating | CreateFailed

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

Creating 創(chuàng)建中

Available 可用

UnAvailable 不可用

CreateFailed 創(chuàng)建失敗

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

system | self | others | marketplace

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

system 阿里云官方提供鏡像

self 用戶自定義鏡像

others 非自己的可用鏡像

marketplace 鏡像市場(chǎng)提供的鏡像

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

　　返回參數(shù)

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

　　錯(cuò)誤碼

錯(cuò)誤代碼 描述 Http 狀態(tài)碼 語(yǔ)義
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   無(wú)效的 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 不合法  

　　示例

　　請(qǐng)求示例

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

　　&RegionId=cn-hangzhou

　　&<公共請(qǐng)求參數(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