查询镜像

更新时间:2017-09-06 09:12:14

描述

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

默认查询出公有镜像,如果查询出自定义镜像,Shared需要传false。

请求参数

参数名 参数类型 是否必填 参数说明
Action String

操作方法

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/?Action=DescribeImages
&Region=cn-wuxi1
&AccessKeyId=6792aa42d288422ab8dd4654dfe727c4
&Date=2017-08-29T02%3A54%3A06%20%2B0000
&Id.0=t-3a8hh7se5j57w
&公共参数

返回示例


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