Image API v1

For details on how to use image, see Using OpenStack Image

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, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)
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