%common;]>

Identifier for an image stored via the Image API, typically a UUID.

Identifier for a tenant managed by the Identity service. The Tenant ID can also be labeled as your account number.

Register a New Virtual Machine 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 all the unique names of all other user’s images.

Valid values are one of aki, ari, ami, raw, iso, vhd, vdi, qcow2, or vmdk.

The disk format of a virtual machine image is the format of the underlying disk image. Virtual appliance vendors have different formats for laying out the information contained in a virtual machine disk image.

You can set your image’s container format to one of the following:

  • raw

    This is an unstructured disk image format

  • vhd

    This is the VHD disk format, a common disk format used by virtual machine monitors from VMWare, Xen, Microsoft, VirtualBox, and others

  • vmdk

    Another common disk format supported by many common virtual machine monitors

  • vdi

    A disk format supported by VirtualBox virtual machine monitor and the QEMU emulator

  • iso

    An archive format for the data contents of an optical disc (e.g. CDROM).

  • qcow2

    A disk format supported by the QEMU emulator that can expand dynamically and supports Copy on Write

  • aki

    This indicates what is stored in Glance is an Amazon kernel image

  • ari

    This indicates what is stored in Glance is an Amazon ramdisk image

  • ami

    This indicates what is stored in Glance is an Amazon machine image

The container format refers to whether the virtual machine image is in a file format that also contains metadata about the actual virtual machine.

There are two main types of container formats: OVF and Amazon’s AMI. In addition, a virtual machine image may have no container format at all – basically, it’s just a blob of unstructured data.

You can set your image’s container format to one of the following:

  • ovf

    This is the OVF container format

  • bare

    This indicates there is no container or metadata envelope for the image

  • aki

    This indicates what is stored in Glance is an Amazon kernel image

  • ari

    This indicates what is stored in Glance is an Amazon ramdisk image

  • ami

    This indicates what is stored in Glance is an Amazon machine image

A location for the image identified by a URI.

Updating an Image/Uploading an Image File or Updating Image Metadata

List details of the specified image.

Deletes the specified image.

Requesting a List of VM Images shared with a given tenant.

Requesting a List of Public VM Images

Name of the image as a string.

Value of the container format, such as ovf, bare, aki, ari, or ami.

Value of the disk format.

Filter on the status of the image, such as queued, saving, active, killed, deleted, and pending_delete..

Value of the minimum size of the image in bytes.

Value of the maximum size of the image in bytes.

List available images (all details).

Name of the image as a string.

Value of the container format, such as ovf, bare, aki, ari, or ami.

Value of the disk format.

Filter on the status of the image, such as queued, saving, active, killed, deleted, and pending_delete.

Value of the minimum size of the image in bytes.

Value of the maximum size of the image in bytes.

Show the next item in the list.

Show the previous item in the list.

Adding a Member to an Image

Set to true if you want to authorize a tenant access to a private image.

With no body, this will add the membership to the image, leaving existing memberships unmodified and defaulting new memberships to have can_share set to false.

Replacing a Membership List for an Image

Removing a Member from an Image

The member_id field identifies a tenant with which the image is shared.