Previous topic

The nova.flags Module

Next topic

The nova.image.s3 Module

This Page

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

The nova.image.glance Module

Implementation of an image service that uses Glance as the backend

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 id.

Raises :AlreadyExists if the image already exist.
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.
delete_all()

Clears out all images.

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.

show(context, image_id)

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

update(context, image_id, image_meta, data=None, features=None)

Replace the contents of the given image with the new data.

Raises :ImageNotFound if the image does not exist.
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)
pick_glance_api_server()

Return which Glance API server to use for the request

This method provides a very primitive form of load-balancing suitable for testing and sandbox environments. In production, it would be better to use one IP and route that to a real load-balancer.

Returns (host, port)