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)¶ -
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
-
delete_image
(image, ignore_missing=True)¶ Delete an image
Parameters: Returns: None
-
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 toTrue
, None will be returned when attempting to find a nonexistent resource.
Returns: One
Image
or 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.
-
Image API v2¶
For details on how to use image, see Using OpenStack Image
The Image v2 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.v2._proxy.
Proxy
(session)¶ -
upload_image
(container_format=None, disk_format=None, data=None, **attrs)¶ Upload a new image from attributes
Parameters: - container_format – Format of the container. A valid value is ami, ari, aki, bare, ovf, ova, or docker.
- disk_format – The format of the disk. A valid value is ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, or iso.
- data – The data to be uploaded as an image.
- 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:
-
download_image
(image)¶ Download an image
Parameters: image – The value can be either the ID of an image or a Image
instance.Returns: The bytes comprising the given Image.
-
delete_image
(image, ignore_missing=True)¶ Delete an image
Parameters: Returns: None
-
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 toTrue
, None will be returned when attempting to find a nonexistent resource.
Returns: One
Image
or None
-
get_image
(image)¶ Get a single image
Parameters: image – The value can be the ID of a image or a Image
instance.Returns: One Image
Raises: ResourceNotFound
when no resource can be found.
-
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
-
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
-
deactivate_image
(image)¶ Deactivate an image
Parameters: image – Either the ID of a image or a Image
instance.Returns: None
-
reactivate_image
(image)¶ Deactivate an image
Parameters: image – Either the ID of a image or a Image
instance.Returns: None
-
add_tag
(image, tag)¶ Add a tag to an image
Parameters: Returns: None
-
remove_tag
(image, tag)¶ Remove a tag to an image
Parameters: Returns: None
-
add_member
(image, **attrs)¶ Create a new member from attributes
Parameters: Returns: The results of member creation
Return type:
-
remove_member
(member, image, ignore_missing=True)¶ Delete a member
Parameters: Returns: None
-
find_member
(name_or_id, image, ignore_missing=True)¶ Find a single member
Parameters: - name_or_id – The name or ID of a member.
- image – This is the image that the member belongs to,
the value can be the ID of a image or a
Image
instance. - ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the resource does not exist. When set toTrue
, None will be returned when attempting to find a nonexistent resource.
Returns: One
Member
or None
-
get_member
(member, image)¶ Get a single member on an image
Parameters: Returns: One
Member
Raises: ResourceNotFound
when no resource can be found.
-
members
(image)¶ Return a generator of members
Parameters: image – This is the image that the member belongs to, the value can be the ID of a image or a Image
instance.Returns: A generator of member objects Return type: Member
-
update_member
(member, image, **attrs)¶ Update the member of an image
Parameters: Attrs kwargs: The attributes to update on the member represented by
value
.Returns: The updated member
Return type:
-