# 查询镜像列表（废弃）
#### 功能介绍
查询所有镜像的列表信息。
当前API已废弃，请使用["查询镜像列表"](https://support.huaweicloud.com/api-ims/ims_03_0602.html)。
#### URI
GET /v2.1/{project_id}/images?name={name}\&status={status}\&changes-since={changes-since}\&minRam={minRam}\&minDisk={inDisk}
参数说明请参见[表1]。
 表1路径参数 
| 参数         | 是否必选 | 描述                                                                                                             |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
   
![](https://support.huaweicloud.com/api-ecs/public_sys-resources/note_3.0-zh-cn.png)
支持分页查询。分页查询的相关信息，请参见[分页查询](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0020805967.html#ZH-CN_TOPIC_0020805967__section1098071718385)。
可以将如下作为URI参数，过滤查询结果。使用方式：/v2/{project_id}/images? name ={name}\&status={status}
查询参数如[表2]所示。
 表2查询参数 
| 参数            | 是否必选 | 参数类型    | 描述                                                                                                                                               |
|:---|:---|:---|:---|
| name          | 否    | String  | 镜像名称。                                                                                                                                            |
| status        | 否    | String  | 镜像状态。 不支持使用"deleted"状态过滤查询，且指定的状态必须是镜像在glance中的状态。nova和glance中的镜像状态映射关系如[表3]所示。 |
| changes-since | 否    | String  | 过滤在changes-since时间之后更新过的镜像。ISO8601时间格式，例如：2013-06-09T06:42:18Z。                                                                                  |
| minRam        | 否    | Integer | 镜像要求的最小内存大小，单位MiB。                                                                                                                               |
| minDisk       | 否    | Integer | 镜像要求的最小磁盘大小，单位GiB。                                                                                                                               |
   
 表3nova和glance中的镜像状态映射关系 
| glance中的镜像状态 | nova显示的镜像状态 |
|:---|:---|
| queued       | saving      |
| saving       | saving      |
| active       | active      |
| deleted      | deleted     |
   
#### 请求消息
无
#### 响应消息
响应参数如[表4]所示。
 表4响应参数 
| 参数           | 是否必选 | 参数类型             | 描述          |
|:---|:---|:---|:---|
| images       | 是    | Array of objects | 镜像信息        |
| images_links | 否    | Array of objects | 分页查询时下一页的信息 |
   
表5images参数信息 
| 参数    | 是否必选 | 参数类型             | 描述           |
|:---|:---|:---|:---|
| id    | 是    | String           | 镜像ID，UUID格式。 |
| links | 是    | Array of objects | 镜像相关快捷链接地址   |
| name  | 是    | String           | 镜像名称         |
   
表6images_links参数信息 
| 参数   | 是否必选 | 参数类型   | 描述         |
|:---|:---|:---|:---|
| href | 是    | String | 分页查询下一页URL |
| rel  | 是    | String | 分页查询方向     |
   
表7links参数信息 
| 参数   | 是否必选 | 参数类型   | 描述                                                                                                                                                |
|:---|:---|:---|:---|
| href | 是    | String | 相应资源的链接。                                                                                                                                          |
| rel  | 是    | String | 有三种取值。self：自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。alternate：备用链接可以包含资源的替换表示形式。例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。 |
| type | 否    | String | type属性提供了一个提示，用于在跟踪该链接时期望的表示类型。                                                                                                                   |
   
#### 请求示例
```
GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/images
```
#### 响应示例
```
{
    "images": [
        {
            "id": "ee10f19c-503c-44af-af2f-73d5e42f7a17",
            "links": [
                {
                    "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "self"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "bookmark"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "alternate",
                    "type": "application/vnd.openstack.image"
                }
            ],
            "name": "image1"
        }
    ]
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。