openstack/glance
Code Issues Proposed changes
8d73de6a83
glance/doc/source/statuses.rst
Sabari Kumar Murugesan 93b81315c6 Remove state transition from active to queued 
After commit Ieb03aaba887492819f9c58aa67f7acfcea81720e it is no
longer necessary to maintain a state transition from ACTIVE to
QUEUED. The only time this happened was when someone removed
the last location from an image. Since this was removed we
don't need it anymore.

Also, updates the image state transition images and docs to
represent the current state transitions.

Closes-Bug: #1555448

Change-Id: I390ae2a7110f06046f38914e946139b3b729bd2d
2016-03-10 06:22:11 +00:00

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

  • deactivated

    Denotes that access to image data is not allowed to any non-admin user. Prohibiting downloads of an image also prohibits operations like image export and image cloning that may require image data.

  • 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 similar to deleted, however, Glance has not yet removed the image data. An image in this state is not recoverable.

This is a representation of how the image move from one status to the next.
  • Add location from zero to more than one.

Task Statuses

Tasks in Glance can be in one the following statuses:

  • pending

    The task identifier has been reserved for a task in the Glance. No processing has begun on it yet.

  • processing

    The task has been picked up by the underlying executor and is being run using the backend Glance execution logic for that task type.

  • success

    Denotes that the task has had a successful run within Glance. The result field of the task shows more details about the outcome.

  • failure

    Denotes that an error occurred during the execution of the task and it cannot continue processing. The message field of the task shows what the error was.