openstack/glance
Code Issues Proposed changes
448ef4a899
glance/doc/source/statuses.rst
Fei Long Wang 5ebf2e0b9b Adding an image status transition diagram for dev doc 
Now there is no image status transition diagram in the dev
doc, this patch will add one and keep the image source as
a dot file so that it can be updated easily in the future.
See http://www.graphviz.org to get more info about .dot file.

Fixes bug 1244995

Change-Id: I076c461f688be93eab8d3d1fa541990d7b79da5e
2013-11-25 13:13:56 +08:00

2.2 KiB
Raw Blame History

Image Statuses

Images in Glance can be in one the following statuses:

  • queued

    The image identifier has been reserved for an image in the Glance registry. No image data has been uploaded to Glance and the image size was not explicitly set to zero on creation.

  • saving

    Denotes that an image's raw data is currently being uploaded to Glance. When an image is registered with a call to POST /images and there is an x-image-meta-location header present, that image will never be in the saving status (as the image data is already available in some other location).

  • active

    Denotes an image that is fully available in Glance. This occurs when the image data is uploaded, or the image size is explicitly set to zero on creation.

  • killed

    Denotes that an error occurred during the uploading of an image's data, and that the image is not readable.

  • deleted

    Glance has retained the information about the image, but it is no longer available to use. An image in this state will be removed automatically at a later date.

  • pending_delete

    This is similiar to deleted, however, Glance has not yet removed the image data. An image in this state is recoverable.

This is a representation of how the image move from one status to the next.
  • Add location from zero to more than one.
  • Remove location from one or more to zero by PATCH method which is only supported in v2.