查詢鏡像

描述

查(cha)(cha)詢鏡(jing)像(xiang)信息，查(cha)(cha)詢一條或者(zhe)多條可用鏡(jing)像(xiang)信息，可根據標識、操作(zuo)系統標識、用途、名稱(cheng)等條件查(cha)(cha)詢。

默認(ren)查(cha)詢(xun)出公(gong)有鏡像，如果查(cha)詢(xun)出自(zi)定(ding)義鏡像，Shared需要傳false。

請求參數

參數名	參數類型	是否必填	參數說明
Action	String	是	操作方法：DescribeImages
Region	String	是	機房標識，取值參見地域列表
Offset	Integer	否	記錄偏移量，不指定取 0
Count	String	否	記錄數量，不指定為全部
Id.N	String	否	鏡像id，支持批量，N為自然數，格式：&Id.0=xxx&Id.1=xxx等
Name	String	否	名稱

返回參數

名稱	類型	說明
Action	String	執行的操作
TaskId	String	請求標識
TotalCount	Integer	過濾條件下總共記錄數
ImageSet	ImageSetItemType	由ImageSetItemType 組成的數組格式，返回鏡像的信息

ImageSetItemType

鏡像信息的數據類型

名稱	類型	說明
Id	String	鏡像標識
Name	String	名稱
Description	String	描述
Size	Integer	大小，單位為 GiB
OsId	String	操作系統ID
OsName	String	操作系統名稱
Shared	String	是否共享
Owner	String	所有者
Status	Boolean	狀態NORMAL, CREATING;
Use	String	用途：云主機（INSTANCE）,SPARK（暫定）,RDS
HotUpgrade	Boolean	是否支持熱升級 true false
CreateTime	DateTime	創建時間
InstanceNum	Integer	通過鏡像創建的云主機數量
templateImageType	String	模板類型

請求示例

//api.cn-henji.com/v2/?Action=DescribeImages
&Region=cn-wuxi1
&AccessKeyId=6792aa42d288422ab8dd4654dfe727c4
&Date=2017-08-29T02%3A54%3A06%20%2B0000
&Id.0=t-3a8hh7se5j57w
&公共參(can)數

返回示例

{
    "code": 10000,
    "message": "",
    "data": {
        "TaskId": "bmu8h20170829105344467";,
        "Action": "DescribeImages",
        "TotalCount": 1,
        "ImageSet": [
           {
                "Id": "t-3a8hh7se5j57w",
                "Name": "tse13",
                "Description": null,
                "OsId": "o-35g8eada2l",
                "OsName": "Windows2008 64",
                "Shared": false,
                "Owner": "18359988",
                "CreateTime": "2017-08-28T14: 41: 55 +0800",
                "Use": "INSTANCE",
                "HotUpgrade": false,
                "Size": 40,
                "Status": "NORMAL",
                "InstanceNum": 0,
                "TemplateName": "tse13",
                "TemplateImageType": "rbd"
             }
        ]
    }
}