The Image Class

The Image class inherits from Resource.

class openstack.image.v1.image.Image(_synchronized=False, connection=None, **attrs)

The base resource

  • _synchronized (bool) – This is not intended to be used directly. See new() and existing().

  • connection (openstack.connection.Connection) – Reference to the Connection being used. Defaults to None to allow Resource objects to be used without an active Connection, such as in unit tests. Use of self._connection in Resource code should protect itself with a check for None.


Hash of the image data used. The Image service uses this value for verification.


The container format refers to whether the VM image is in a file format that also contains metadata about the actual VM. Container formats include OVF and Amazon AMI. In addition, a VM image might not have a container format - instead, the image is just a blob of unstructured data.


A URL to copy an image from


The timestamp when this image was created.


Valid values are: aki, ari, ami, raw, iso, vhd, vdi, qcow2, or vmdk. The disk format of a VM image is the format of the underlying disk image. Virtual appliance vendors have different formats for laying out the information contained in a VM disk image.


Defines whether the image can be deleted. Type: bool


True if this is a public image. Type: bool


A location for the image identified by a URI


The minimum disk size in GB that is required to boot the image.


The minimum amount of RAM in MB that is required to boot the image.


Name for the image. Note that the name of an image is not unique to a Glance node. The API cannot expect users to know the names of images owned by others.


The ID of the owner, or project, of the image.


The ID of the owner, or project, of the image. (backwards compat)


Properties, if any, that are associated with the image.


The size of the image data, in bytes.


The image status.


The timestamp when this image was last updated.

classmethod find(session, name_or_id, ignore_missing=True, **params)

Find a resource by its name or id.

  • session (Adapter) – The session to use for making this request.

  • name_or_id – This resource’s identifier, if needed by the request. The default is None.

  • 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.

  • params (dict) – Any additional parameters to be passed into underlying methods, such as to existing() in order to pass on URI parameters.


The Resource object matching the given name or id or None if nothing matches.


openstack.exceptions.DuplicateResource if more than one resource is found for this request.


openstack.exceptions.ResourceNotFound if nothing is found and ignore_missing is False.