• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Glance
  5. Image (Native OpenStack APIs)
  6. Querying Image Details (Native OpenStack API v1.1 - Abandoned and Not Recommended)

Querying Image Details (Native OpenStack API v1.1 - Abandoned and Not Recommended)

Function

This API is used to query details of images.

This API has been discarded. The image query API (Querying Images (Native OpenStack API)) is recommended.

URI

URI format

GET /v1.1/images/detail

Request

  • Parameter description

    Parameters name, container_format, disk_format, status, size_min, size_max, and changes-since can be used to filter the query result.

    Parameter

    Type

    Mandatory

    Description

    name

    String

    No

    Specifies the image name. For detailed description, see Image Attributes.

    container_format

    String

    No

    Image container type

    disk_format

    String

    No

    Image file format

    status

    String

    No

    Image status

    size_min

    String

    No

    Minimum size of the image

    size_max

    String

    No

    Maximum size of the image

    changes-since

    String

    No

    Last update time

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

Response

  • Parameter description

    Parameter

    Type

    Description

    status

    String

    Image status

    virtual_size

    Int

    Virtual size of an image

    name

    String

    Specifies the image name. For detailed description, see Image Attributes.

    deleted

    Bool

    Whether an image has been deleted

    container_format

    String

    Image container type

    created_at

    Datetime

    Time when an image was created

    disk_format

    String

    Image file type

    updated_at

    Datetime

    Time when an image was updated

    properties

    Dict

    Image attribute

    owner

    String

    Tenant to which an image belongs

    protected

    Bool

    Whether an image is protected

    min_ram

    Int

    Minimum memory (MB) required for running an image

    checksum

    String

    Image verification sum. This parameter is available after an image file is uploaded.

    min_disk

    Int

    Minimum disk capacity (GB) required for running the image

    is_public

    Bool

    Whether an image is a public one

    deleted_at

    Datetime

    Time when an image was deleted

    id

    String

    Image UUID

    size

    Int

    Image size. This parameter is available after an image file is uploaded.

  • Example response
    HTTP/1.1 200 OK
    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": none,
                "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
            }
        ]
    }

Error Codes

N/A