Previous topic

The cinder.flags Module

Next topic

The cinder.manager Module

This Page

Psst... hey. You're reading the latest content, but it might be out of sync with code. You can read Cinder 2011.2 docs or all OpenStack docs too.

The cinder.image.glance Module

Implementation of an image service that uses Glance as the backend

class GlanceClientWrapper(context=None, host=None, port=None, version=None)

Bases: object

Glance client wrapper class that implements retries.

call(context, version, method, *args, **kwargs)

Call a glance client method. If we get a connection error, retry the request according to FLAGS.glance_num_retries.

class GlanceImageService(client=None)

Bases: object

Provides storage and retrieval of disk image objects within Glance.

create(context, image_meta, data=None)

Store the image data and return the new image object.

delete(context, image_id)

Delete the given image.

Raises :ImageNotFound if the image does not exist.
Raises :NotAuthorized if the user is not an owner.
detail(context, **kwargs)

Calls out to Glance for a list of detailed image information.

download(context, image_id, data)

Calls out to Glance for metadata and data and writes data.

get_location(context, image_id)

Returns the direct url representing the backend storage location, or None if this attribute is not shown by Glance.

show(context, image_id)

Returns a dict with image data for the given opaque image id.

update(context, image_id, image_meta, data=None, purge_props=True)

Modify the given image with the new data.

get_api_servers()

Shuffle a list of FLAGS.glance_api_servers and return an iterator that will cycle through the list, looping around to the beginning if necessary.

get_default_image_service()
get_remote_image_service(context, image_href)

Create an image_service and parse the id from the given image_href.

The image_href param can be an href of the form ‘http://example.com:9292/v1/images/b8b2c6f7-7345-4e2f-afa2-eedaba9cbbe3‘, or just an id such as ‘b8b2c6f7-7345-4e2f-afa2-eedaba9cbbe3’. If the image_href is a standalone id, then the default image service is returned.

Parameters:image_href – href that describes the location of an image
Returns:a tuple of the form (image_service, image_id)