tencentyun#intlcloud-documents#查看镜像列表2

>? **当前页面接口为旧版 API，未来可能停止维护，目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 云服务器 API 3.0。** > ## 1. 接口描述 本接口(DescribeImages) 用于查看镜像列表。 接口请求域名：image.api.qcloud.com。 *可以通过指定镜像ID来查询指定镜像的详细信息，或通过设定过滤器来查询满足过滤条件的镜像的详细信息。 *指定偏移(Offset)和限制(Limit)来选择结果中的一部分，默认返回满足条件的前20个镜像信息。 ## 2. 输入参数 以下请求参数列表仅列出了接口请求参数，其它参数可参考[公共请求参数](/document/api/213/6976)。 | 参数名称 | 类型 |是否必选| 描述 | |---------|---------|---------|---------| |Version|String|是|表示API版本号，主要用于标识请求的不同API版本。 本接口第一版本可传：2017-03-12。| | ImageIds.N | array of Strings |否 | 镜像ID列表 。镜像ID如：`img-gvbnzy6f`。array型参数的格式可以参考[API简介](/document/api/213/11646)。镜像ID可以通过如下方式获取：

通过[DescribeImages](/document/api/213/9418)接口返回的`ImageId`获取。

通过[镜像控制台](https://console.cloud.tencent.com/cvm/image)获取。| | Filters.N |array of [Filter](/document/api/213/9451#filter) objects|否 | 过滤条件，详见下表-镜像过滤条件表。其中Fil