文档首页/ 镜像服务 IMS/ API参考(吉隆坡区域)/ OpenStack原生API/ 镜像(OpenStack原生)/ 查询镜像详情(OpenStack原生v1.1--已废弃,不推荐使用)
更新时间:2024-04-17 GMT+08:00

查询镜像详情(OpenStack原生v1.1--已废弃,不推荐使用)

功能介绍

查询镜像列表详情。

当前接口已废弃,推荐使用查询镜像列表(OpenStack原生)

URI

GET /v1.1/images/detail

请求消息

请求参数

可以把name、container_format、disk_format、status、size_min、size_max、changes-since作为uri参数,过滤查询结果。

参数

是否必选

参数类型

描述

name

String

镜像名称。name参数说明请参考镜像属性

container_format

String

镜像容器类型

disk_format

String

镜像文件格式

status

String

镜像状态

size_min

String

镜像不小于

size_max

String

镜像不大于

changes-since

String

镜像最后更新时间

请求示例

查询镜像详情。

GET https://{Endpoint}/v1.1/images/detail?disk_format=qcow2

响应消息

  • 响应参数

    参数

    参数类型

    描述

    status

    String

    镜像状态

    virtual_size

    Integer

    镜像虚拟大小

    name

    String

    镜像名称。name参数说明请参考镜像属性

    deleted

    Boolean

    镜像是否已删除

    container_format

    String

    镜像容器类型

    created_at

    String

    镜像创建时间

    disk_format

    String

    镜像文件类型

    updated_at

    String

    镜像更新时间

    properties

    Object

    镜像属性

    owner

    String

    镜像所属租户

    protected

    Boolean

    镜像是否受保护

    min_ram

    Integer

    运行镜像所需最小内存,单位MB

    checksum

    String

    镜像校验和,上传镜像文件后存在

    min_disk

    Integer

    运行镜像所需最小磁盘,单位GB

    is_public

    Boolean

    是否为公共镜像

    deleted_at

    String

    镜像删除时间

    id

    String

    镜像UUID

    size

    Integer

    镜像大小,上传镜像文件后存在

  • 响应样例
    HTTP/1.1 200 OK
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    Content-Type: application/json; charset=UTF-8
    Content-Length: 495
    X-Openstack-Request-Id: req-68327dda-8078-41fe-b091-01a09ec073da
    Date: Mon, 23 May 2016 02:32:28 GMT
    {
        "images": [
            {
                "status": "active",
                "deleted_at": null,
                "name": "cirros",
                "deleted": false,
                "container_format": "bare",
                "created_at": "2016-05-22T06:04:20.425843",
                "disk_format": "qcow2",
                "updated_at": "2016-05-22T06:04:22.719791",
                "min_disk": 0,
                "protected": false,
                "id": "3c3d1d01-b48a-4639-8a88-08be3b9b5d78",
                "min_ram": 0,
                "checksum": "64d7c1cd2b6f60c92c14662941cb7913",
                "owner": "23f4cb75768d4febb39542ef6fe169f3",
                "is_public": true,
                "virtual_size": null,
                "properties": {
                },
                "size": 13167616
            }
        ]
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。