查询可用的镜像列表

最近更新时间:2017-03-30 17:33:02

1. 接口描述

本接口 (DescribeImages) 用于获取用户能够使用的镜像,可以使用这些镜像来创建CVM实例。

接口请求域名:image.api.qcloud.com

  • 可以通过镜像ID进行查询(最多指定10个镜像ID);同时,也可以根据镜像的状态或者类型来进行过滤。
  • 镜像拥有5个状态,用户可以根据需要来进行过滤:
    • 1: 创建中
    • 2: 正常
    • 3: 使用中
    • 4: 同步中
    • 5: 复制中
  • 镜像拥有4个类型,用户可以根据需要来进行过滤:

    • 1: 私有镜像 (本帐户创建的镜像)
    • 2: 公共镜像 (腾讯云官方镜像)
    • 3: 服务市场 (服务市场提供的镜像)
    • 4: 共享镜像(其他账户共享给本帐户的镜像)
  • 北美地区不支持服务市场。

  • 常用公共镜像ID一览:

镜像名称 unImgId/unImageId
CentOS 5.8 32位 img-7br3ouzr
CentOS 5.8 64位 img-4cq5l3u1
CentOS 5.11 32位 img-ko6c8e6f
CentOS 5.11 64位 img-ailu7ftt
CentOS 6.2 64位 img-50mr2ow7
CentOS 6.3 32位 img-1afi29f3
CentOS 6.3 64位 img-4w43a15z
CentOS 6.4 32位 img-k09t26i1
CentOS 6.4 64位 img-jlo93805
CentOS 6.5 32位 img-7uq6rrhr
CentOS 6.5 64位 img-7fwdvfur
CentOS 6.6 32位 img-5jbd8jxn
CentOS 6.6 64位 img-h5le2uy5
CentOS 6.7 32位 img-ljriodz5
CentOS 6.7 64位 img-9iwld2rx
CentOS 7.0 64位 img-b1ve77s9
CentOS 7.1 64位 img-9q2lxkar
CentOS 7.2 64位 img-31tjrtph
Debian 7.4 64位 img-c1l6bgb1
Debian 7.8 32位 img-2p1g2wjv
Debian 7.8 64位 img-feqctcrx
Debian 8.2 32位 img-ez7jwngr
Debian 8.2 64位 img-hi93l4ht
Ubuntu Server 12.04 LTS 64位 (Docker) img-aa9z7opt
Ubuntu Server 14.04.1 LTS 32位 img-qpxvpujt
Ubuntu Server 14.04.1 LTS 64位 img-3wnd9xpl
openSUSE 12.3 32位 img-8bf2kz5x
openSUSE 12.3 64位 img-1p6m0vz5
openSUSE 13.2 64位 img-pmhtrjdx
SUSE Linux Enterprise Server 11 SP3 64位 img-mg89zx1h
SUSE Linux Enterprise Server 12 64位 img-d5304izr
FreeBSD 10.1 64位 img-871lthrb
CoreOS 717.3.0 64位 img-6mre94jv
Windows Server 2008 R2 企业版 SP1 64位 img-0vbqvzfn
Windows Server 2012 R2 标准版 64位英文版 img-lkxqa4kj
Windows Server 2012 R2 标准版 64位中文版 img-egif9bvl
Windows Server 2012 R2 数据中心版 64位英文版 img-2tddq003
Windows Server 2012 R2 数据中心版 64位中文版 img-29hl923v

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见公共请求参数页面。

参数名称 是否必选 类型 描述
imageType Int 按照镜像的类型过滤;具体值见上。
imageIds.n String 按照镜像ID过滤;如果指定了镜像ID,imageType则为必选(此接口支持同时传入多个ID。此参数的具体格式可参考API简介id.n一节)。
status Int 按照镜像的状态过滤。默认值为0,查询全部镜像。具体值见上。
offset Int 偏移量,默认为0。关于offset的更进一步介绍参考 API 简介中的相关小节。
limit Int 返回数量,默认 20,最大值 100。关于limit的更进一步介绍参考 API 简介中的相关小节。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。详见错误码页面的模块错误码
totalCount Int 符合条件的镜像数量。
imageSet Array 符合条件的镜像信息。

其中 imageSet 存储了镜像具体的信息,构成如下:

参数名称 类型 描述
unImgId String 硬盘镜像ID,命名格式为“img-xxxxxxxx”,使用此ID标识镜像。
imageName String 硬盘镜像名称。
imageDescription String 描述信息。
imageType Int 镜像类型。具体值见上。
osName String 操作系统名称。
createTime String 创建时间。
creator String 创建者的账号。
status Int 镜像的状态。具体值见上。

4. 示例

输入

  https://image.api.qcloud.com/v2/index.php?Action=DescribeImages
  &imageType=1
  &<公共请求参数>

输出


{
    "code" : 0,
    "message" : "",
    "totalCount" : 1,
    "imageSet" : [
        {
            "unImgId" : "img-1234test",
            "imageName" : "test",
            "imageDescription" : "test",
            "osName" : "Ubuntu 12.04 64bit",
            "imageType" : 1,
            "createTime" : "2014-09-27 10:11:00",
            "createor" : “1000”,
            "status" : 2
        }
    ]
}