openstack
/
glance
Code Issues Proposed changes

Update image statuses doc for latest change 

1.correct typo
2.add new state 'uploading' and 'importing'

Change-Id: I9962fb5f450f13c6a92bce826767ee880e7e7afe
Closes-bug: 1713442
This commit is contained in:
Rui Yuan Dou 2017-08-14 13:44:49 +08:00
parent a6fa8d9ce7
commit 824daf51dc
3 changed files with 39 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/source/images/image_status_transition.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 164 KiB

After

Width:  |  Height:  |  Size: 245 KiB

9
doc/source/images_src/image_status_transition.dot
View File

@ -31,6 +31,7 @@ digraph {
"queued" -> "active" [label="add location*"];
"queued" -> "saving" [label="upload"];
"queued" -> "uploading" [label="stage upload"];
"queued" -> "deleted" [label="delete"];
"saving" -> "active" [label="upload succeed"];
@ -38,6 +39,14 @@ digraph {
"saving" -> "queued" [label="[v2] upload fail"];
"saving" -> "deleted" [label="delete"];
"uploading" -> "importing" [label="import"];
"uploading" -> "queued" [label="stage upload fail"];
"uploading" -> "deleted" [label="delete"];
"importing" -> "active" [label="import succeed"];
"importing" -> "queued" [label="import fail"];
"importing" -> "deleted" [label="delete"];
"active" -> "pending_delete" [label="delayed delete"];
"active" -> "deleted" [label="delete"];
"active" -> "deactivated" [label="deactivate"];

33
doc/source/user/statuses.rst
View File

@ -19,7 +19,7 @@
Image Statuses
==============
Images in Glance can be in one the following statuses:
Images in Glance can be in one of the following statuses:
* ``queued``
@ -35,6 +35,19 @@ Images in Glance can be in one the following statuses:
the `saving` status (as the image data is already available in some other
location).
* ``uploading``
Denotes that an import data-put call has been made. While in this status, a
call to `PUT /file` is disallowed. (Note that a call to `PUT /file` on a
queued image puts the image into saving status. Calls to `PUT /stage` are
disallowed while an image is in saving status. Thus it’s not possible to use
both upload methods on the same image.)
* ``importing``
Denotes that an import call has been made but that the image is not yet ready
for use.
* ``active``
Denotes an image that is fully available in Glance. This occurs when
@ -69,13 +82,15 @@ Images in Glance can be in one the following statuses:
:align: center
:alt: The states consist of:
"queued", "saving", "active", "pending_delete", "deactivated",
"killed", and "deleted".
"uploading", "importing", "killed", and "deleted".
The transitions consist of:
An initial transition to the "queued" state called "create image".
A transition from the "queued" state to the "active" state
called "add location".
A transition from the "queued" state to the "saving" state
called "upload".
A transition from the "queued" state to the "uploading" state
called "stage upload".
A transition from the "queued" state to the "deleted" state
called "delete".
A transition from the "saving" state to the "active" state
@ -86,6 +101,18 @@ Images in Glance can be in one the following statuses:
called "[v1] upload fail".
A transition from the "saving" state to the "queued" state
called "[v2] upload fail".
A transition from the "uploading" state to the "importing" state
called "import".
A transition from the "uploading" state to the "queued" state
called "stage upload fail".
A transition from the "uploading" state to the "deleted" state
called "delete".
A transition from the "importing" state to the "active" state
called "import succeed".
A transition from the "importing" state to the "queued" state
called "import fail".
A transition from the "importing" state to the "deleted" state
called "delete".
A transition from the "active" state to the "deleted" state
called "delete".
A transition from the "active" state to the "pending_delete" state
@ -112,7 +139,7 @@ Images in Glance can be in one the following statuses:
Task Statuses
=============
Tasks in Glance can be in one the following statuses:
Tasks in Glance can be in one of the following statuses:
* ``pending``