Image API v1¶

The Image v1 Class¶

The image high-level interface is available through the image member of a Connection object. The image member will only be added if the service is detected.

class openstack.image.v1._proxy.Proxy(session)¶

upload_image(**attrs)¶

Upload a new image from attributes

Parameters:	attrs (dict) – Keyword arguments which will be used to create a Image, comprised of the properties on the Image class.
Returns:	The results of image creation
Return type:	Image

update_image(image, **attrs)¶

Update a image

Parameters:	image – Either the ID of a image or a Image instance.
Attrs kwargs:	The attributes to update on the image represented by value.
Returns:	The updated image
Return type:	Image

delete_image(image, ignore_missing=True)¶

Delete an image

Parameters:	image – The value can be either the ID of an image or a Image instance. ignore_missing (bool) – When set to False ResourceNotFound will be raised when the image does not exist. When set to True, no exception will be set when attempting to delete a nonexistent image.
Returns:	None

get_image(image)¶

Get a single image

Parameters:	image – The value can be the ID of an image or a Image instance.
Returns:	One Image
Raises:	ResourceNotFound when no resource can be found.

find_image(name_or_id, ignore_missing=True)¶

Find a single image

Parameters:	name_or_id – The name or ID of a image. ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.
Returns:	One Image or None

images(**query)¶

Return a generator of images

Parameters:	**query (kwargs) – Optional query parameters to be sent to limit the resources being returned.
Returns:	A generator of image objects
Return type:	Image