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')¶

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.