The glanceclient.v2.images Module

The glanceclient.v2.images Module

class glanceclient.v2.images.Controller(http_client, schema_client)

Bases: object

add_location(image_id, url, metadata)

Add a new location entry to an image’s list of locations.

It is an error to add a URL that is already present in the list of locations.

Parameters:
  • image_id – ID of image to which the location is to be added.
  • url – URL of the location to add.
  • metadata – Metadata associated with the location.
Returns:

The updated image

create(**kwargs)

Create an image.

data(image_id, do_checksum=True)

Retrieve data of an image.

Parameters:
  • image_id – ID of the image to download.
  • do_checksum – Enable/disable checksum validation.
Returns:

An iterable body or None

deactivate(image_id)

Deactivate an image.

delete(image_id)

Delete an image.

delete_locations(image_id, url_set)

Remove one or more location entries of an image.

Parameters:
  • image_id – ID of image from which locations are to be removed.
  • url_set – set of URLs of location entries to remove.
Returns:

None

get(image_id)
get_import_info()

Get Import info from discovery endpoint.

image_import(image_id, method='glance-direct', uri=None)

Import Image via method.

list(**kwargs)

Retrieve a listing of Image objects.

Parameters:page_size – Number of images to request in each paginated request.
Returns:generator over list of Images.
model
reactivate(image_id)

Reactivate an image.

stage(image_id, image_data, image_size=None)

Upload the data to image staging.

Parameters:
  • image_id – ID of the image to upload data for.
  • image_data – File-like object supplying the data to upload.
  • image_size – Unused - present for backwards compatibility
unvalidated_model
update(image_id, remove_props=None, **kwargs)

Update attributes of an image.

Parameters:
  • image_id – ID of the image to modify.
  • remove_props – List of property names to remove
  • kwargs – Image attribute names and their new values.
update_location(image_id, url, metadata)

Update an existing location entry in an image’s list of locations.

The URL specified must be already present in the image’s list of locations.

Parameters:
  • image_id – ID of image whose location is to be updated.
  • url – URL of the location to update.
  • metadata – Metadata associated with the location.
Returns:

The updated image

upload(image_id, image_data, image_size=None, u_url=None)

Upload the data for an image.

Parameters:
  • image_id – ID of the image to upload data for.
  • image_data – File-like object supplying the data to upload.
  • image_size – Unused - present for backwards compatibility
  • u_url – Upload url to upload the data to.
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.