• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Glance
  5. Images
  6. Show Image Details

Show Image Details

Function Description

This interface is used to query the details about an image and to obtain the information from a database and return the information to the user.

Interface Format

Method

URI

Description

GET

/v2/images/{image_id}

Queries the details about an image.

Restrictions

N/A

Expanded Interface

N/A

Request Parameter

N/A

Response Parameter

Table 1 Response parameters

Parameter

Type

Mandatory

Description

visibility

String

Yes

Specifies whether the image can be viewed by other tenants. The value can be public or private.

name

String

No

Specifies the image name, a string of up to 256 characters.

protected

Bool

Yes

Specifies whether the image is protected. The protected image cannot be deleted.

container_format

String

No

Specifies the container format. The value can be ami, ari, aki, bare, or ovf.

disk_format

String

No

Specifies the disk format. The value can be ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, or iso.

tags

List(String)

Yes

Specifies the image tag, a string of up to 256 characters.

min_ram

Int

Yes

Specifies the minimum size of the memory (MB) that the running image belongs to. The value is less than 2,147,483,648.

min_disk

Int

Yes

Specifies the minimum size of the disk (GB) that the running image belongs to. The value is less than 2,147,483,648.

status

String

Yes

Specifies the image status.

created_at

datetime

Yes

Specifies the date and time when the image was created.

updated_at

datetime

Yes

Specifies the date and time when the image was updated.

self

String

Yes

Specifies the URL for the image.

id

String

Yes

Specifies the image ID.

file

String

Yes

Specifies the URL for the image file that you can upload or download.

schema

String

Yes

Specifies the URL for the schema.

size

Int

Yes

Specifies the image size. This parameter is valid after the image is uploaded.

checksum

String

Yes

Specifies the image checksum. This parameter is valid after the image is uploaded.

virtual_size

Int

Yes

Specifies the virtual size of the image.

Attribute name of a customized image

String

No

Specifies the image attribute. You can specify multiple attribute key pairs, for example, 'a'='b'.

'c'='d'

Request Example

GET /v2/images/130bdcc1-0c00-4684-8f38-57667baf07b6

Response Example

{
    "status": "queued",
    "name": "test",
    "tags": [
        "test",
        "image"
    ],
    "container_format": "bare","created_at": "2014-12-16T01:22:05Z",
    "size": null,
    "disk_format": "qcow2",
    "updated_at": "2014-12-16T01:22:05Z",
    "visibility": "private",
    "self": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90",
    "min_disk": 1,
    "protected": false,
    "id": "4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90","file": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/file",
    "checksum": null,
    "owner": "aed2c611711548a4a9c16fb8fe166af4",
    "min_ram": 1024,
    "schema": "/v2/schemas/image",
    "virtual_size": null
}    

Error Code

N/A