Skip to Main Content
Deploying OpenStack
book

Deploying OpenStack

by Ken Pepple
July 2011
Intermediate to advanced content levelIntermediate to advanced
88 pages
1h 52m
English
O'Reilly Media, Inc.
Content preview from Deploying OpenStack

API Support

The Glance API is a simple REST API for querying image metadata or storing or retrieving actual images. Data is returned as a JSON-encoded mapping (query) or binary (image retrieval). Below is an example of querying Glance using curl for details on all images:

$ curl http://localhost:9292/images
{"images":
    [{"name": "natty-uec",
      "container_format": "ami",
      "disk_format": "ami",
      "checksum": "b420e097baf54cd32af5970b3f0cb93b",
      "id": 6,
      "size": 1476395008}]
}

In this example, Glance shows that there is only one image in the registry.

Caution

The List Images and List Images Detail calls can return huge amounts of data for large image stores, as no record filtering exists in this version of Glance.

The Glance API calls are detailed in Table 3-4.

Table 3-4. Glance API Calls

ActionAPI CallDescription
Store ImagePOST /imagesStores the image and then returns the metadata created about it
Download ImageGET /images/ IDRetrieves image specified by ID
Update ImagePUT /images/ IDUpdate image metadata or actual data specified by ID
Delete ImageDELETE /images/ IDDelete image specified by ID
List ImagesGET /imagesReturn id, name, disk_format, container_format, checksum, and size of all images
List Images DetailGET /images/detailReturn list (with all metadata) of all images
Image DetailsHEAD /images/ IDReturn all metadata for image specified by ID

The full API documentation can be viewed at the online documentation website.

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Start your free trial

You might also like

Troubleshooting OpenStack

Troubleshooting OpenStack

Tony Campbell
Containers in OpenStack

Containers in OpenStack

Pradeep Kumar Singh, Madhuri Kumari

Publisher Resources

ISBN: 9781449311223Errata