• Native OpenStack API

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

Querying Image Metadata (Native OpenStack API v1 - Abandoned and Not Recommended)

Function

This API is used to query image metadata.

This API has been discarded. The API for querying image details (Querying Image Details (Native OpenStack API)) is recommended.

URI

URI format

HEAD /v1/images/{image_id}

Request

  • Example request
    HEAD https://{Endpoint}/v1/images/3c3d1d01-b48a-4639-8a88-08be3b9b5d78

Response

  • Parameter description

    Parameter

    Type

    Description

    Status

    String

    Image status

    Virtual_size

    Int

    Virtual size of an image

    Name

    String

    Image name

    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

    Property

    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.

    These parameters are contained in the header of the HTTP response message.

  • Example response
    HTTP/1.1 200 OK
    Content-Type: text/html; charset=UTF-8
    Content-Length: 0
    X-Image-Meta-Id: 3c3d1d01-b48a-4639-8a88-08be3b9b5d78
    X-Image-Meta-Deleted: False
    X-Image-Meta-Container_format: bare
    X-Image-Meta-Checksum: 64d7c1cd2b6f60c92c14662941cb7913
    X-Image-Meta-Protected: False
    X-Image-Meta-Min_disk: 0
    X-Image-Meta-Created_at: 2016-05-22T06:04:20.425843
    X-Image-Meta-Size: 13167616
    X-Image-Meta-Status: active
    X-Image-Meta-Is_public: True
    X-Image-Meta-Min_ram: 0
    X-Image-Meta-Owner: 23f4cb75768d4febb39542ef6fe169f3
    X-Image-Meta-Updated_at: 2016-05-22T06:04:22.719791
    X-Image-Meta-Disk_format: qcow2
    X-Image-Meta-Name: cirros
    Etag: 64d7c1cd2b6f60c92c14662941cb7913
    X-Openstack-Request-Id: req-7123ca83-da23-4f4e-9ed6-accd3707d333
    Date: Mon, 23 May 2016 02:29:54 GMT

Error Codes

Error Code

Description

404

Not Found

This error code indicates that the specified image does not exist.