Help Center/ Image Management Service/ API Reference/ Historical APIs/ Image (Native OpenStack APIs)/ Querying Image Metadata (Native OpenStack API V1, Discarded)
Updated on 2024-11-14 GMT+08:00

Querying Image Metadata (Native OpenStack API V1, Discarded)

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 V2, Discarded)) is recommended.

Windows images can no longer be queried.

URI

HEAD /v1/images/{image_id}

Table 1 lists the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Type

Description

image_id

Yes

String

Specifies the image ID.

Request

Request parameters

None

Example Request

Querying image metadata

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

Response

  • Response parameters

    Parameter

    Type

    Description

    Status

    String

    Image status

    Virtual_size

    Integer

    Virtual size of an image

    Name

    String

    Image name

    Deleted

    Boolean

    Whether an image has been deleted

    Container_format

    String

    Image container type

    Created_at

    String

    Time when an image was created

    Disk_format

    String

    Image file type

    Updated_at

    String

    Time when an image was updated

    Property

    Object

    Image attribute

    Owner

    String

    Tenant to which an image belongs

    Protected

    Boolean

    Whether an image is protected

    Min_ram

    Integer

    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

    Integer

    Minimum disk capacity (GB) required for running the image

    Is_public

    Boolean

    Whether an image is a public one

    Deleted_at

    String

    Time when an image was deleted

    Id

    String

    Image UUID

    Size

    Integer

    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
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    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
    

Returned Values

  • Normal

    200

  • Abnormal

    Returned Value

    Description

    400 Bad Request

    Request error.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    You do not have the rights to perform the operation.

    404 Not Found

    The requested resource was not found.

    500 Internal Server Error

    Internal service error.

    503 Service Unavailable

    The service is unavailable.