summaryrefslogtreecommitdiff
path: root/doc/source
diff options
context:
space:
mode:
authorMarek Aufart <maufart@redhat.com>2015-06-23 15:11:06 +0200
committerMarek Aufart <maufart@redhat.com>2015-07-02 11:02:17 +0200
commitbd589778c287f1f1b2f7c2dcce7c917e49f956c3 (patch)
tree47bfd42833eb6b6fc3e9f09a2c202b139a79f317 /doc/source
parent2eb0f7287f36764405a4fb82488f95bca67f540c (diff)
downloadpython-openstackclient-bd589778c287f1f1b2f7c2dcce7c917e49f956c3.tar.gz
Move update code from image create command
Openstack image create command updates existing image (with same name) by default. That might be confusing since glance allows create multiple images with same names and may lead to unwanted image update by image create command. Image update code was moved from image create action to image set action. BackwardsIncompatibleImpact Change-Id: I1686c6544c366262efab9e33c066d5f8a667f707 Closes-Bug: #1461817
Diffstat (limited to 'doc/source')
-rw-r--r--doc/source/backwards-incompatible.rst14
-rw-r--r--doc/source/command-objects/image.rst40
2 files changed, 54 insertions, 0 deletions
diff --git a/doc/source/backwards-incompatible.rst b/doc/source/backwards-incompatible.rst
index 437f9324..ae77164b 100644
--- a/doc/source/backwards-incompatible.rst
+++ b/doc/source/backwards-incompatible.rst
@@ -47,6 +47,20 @@ List of Backwards Incompatible Changes
* Bug: https://bugs.launchpad.net/python-openstackclient/+bug/1450872
* Commit: https://review.openstack.org/#/c/179446/
+4. Command `openstack image create` does not update already existing image
+
+ Previously, the image create command updated already existing image if it had
+ same name. It disabled possibility to create multiple images with same name
+ and lead to potentially unwanted update of existing images by image create
+ command.
+ Now, update code was moved from create action to set action.
+
+ * In favor of: Create multiple images with same name (as glance does).
+ * As of: 1.5.0
+ * Removed in: NA
+ * Bug: https://bugs.launchpad.net/python-openstackclient/+bug/1461817
+ * Commit: https://review.openstack.org/#/c/194654/
+
For Developers
==============
diff --git a/doc/source/command-objects/image.rst b/doc/source/command-objects/image.rst
index 18658651..824d4930 100644
--- a/doc/source/command-objects/image.rst
+++ b/doc/source/command-objects/image.rst
@@ -210,6 +210,14 @@ Set image properties
[--size <size>]
[--protected | --unprotected]
[--public | --private]
+ [--store <store>]
+ [--location <image-url>]
+ [--copy-from <image-url>]
+ [--file <file>]
+ [--volume <volume>]
+ [--force]
+ [--checksum <checksum>]
+ [--stdin]
[--property <key=value> [...] ]
<image>
@@ -260,6 +268,38 @@ Set image properties
Image is inaccessible to the public (default)
+.. option:: --store <store>
+
+ Upload image to this store
+
+.. option:: --location <image-url>
+
+ Download image from an existing URL
+
+.. option:: --copy-from <image-url>
+
+ Copy image from the data store (similar to --location)
+
+.. option:: --file <file>
+
+ Upload image from local file
+
+.. option:: --volume <volume>
+
+ Update image with a volume
+
+.. option:: --force
+
+ Force image update if volume is in use (only meaningful with --volume)
+
+.. option:: --checksum <checksum>
+
+ Image hash used for verification
+
+.. option:: --stdin
+
+ Allow to read image data from standard input
+
.. option:: --property <key=value>
Set a property on this image (repeat for multiple values)