查询镜像

描述

查询镜像信息，查询一条或者多条可用镜像信息，可根据标识、操作系统标识、用途、名称等条件查询。

默认查询出公有镜像，如果查询出自定义镜像，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	模板类型

请求示例

https://api.chinac.com/v2/?Action=DescribeImages
&Region=cn-wuxi1
&AccessKeyId=6792aa42d288422ab8dd4654dfe727c4
&Date=2017-08-29T02%3A54%3A06%20%2B0000
&Id.0=t-3a8hh7se5j57w
&公共参数

返回示例

{
    "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"
             }
        ]
    }
}