From 25bdf6811c71413921777cad73b6d039444600ff Mon Sep 17 00:00:00 2001
From: sunyajing <yajing.sun@easystack.cn>
Date: Mon, 13 Jun 2016 10:37:10 +0800
Subject: Modify compute agent set command

Migrate ``compute agent set`` arguments: version, url, md5hash
to be optional.

BackwardsIncompatibleImpact

Change-Id: I092b7ed24274bafa548f0537c4586504be3a2825
Co-Authored-By: Huanxuan Ao <huanxuan.ao@easystack.cn>
---
 doc/source/backwards-incompatible.rst        | 13 +++++++++++++
 doc/source/command-objects/compute-agent.rst | 21 ++++++++++++---------
 2 files changed, 25 insertions(+), 9 deletions(-)

(limited to 'doc/source')

diff --git a/doc/source/backwards-incompatible.rst b/doc/source/backwards-incompatible.rst
index da3c1b64..4f38aa54 100644
--- a/doc/source/backwards-incompatible.rst
+++ b/doc/source/backwards-incompatible.rst
@@ -170,6 +170,19 @@ Releases Before 3.0
   * Bug: https://bugs.launchpad.net/python-openstackclient/+bug/1546065
   * Commit: https://review.openstack.org/#/c/281088/
 
+12. <version> <url> <md5hash> should be optional for command `openstack compute agent set`
+
+  Previously, the command was `openstack compute agent set <id> <version> <url> <md5hash>`,
+  whereas now it is: `openstack compute agent set <id> --version <version>
+                                                       --url <url>
+                                                       --md5hash <md5hash>`.
+
+  * In favor of: making <version> <url> <md5hash> optional.
+  * As of: NA
+  * Removed in: NA
+  * Bug: NA
+  * Commit: https://review.openstack.org/#/c/328819/
+
 13. `aggregate set` commands will no longer return the modified resource
 
   Previously, modifying an aggregate would result in the new aggregate being
diff --git a/doc/source/command-objects/compute-agent.rst b/doc/source/command-objects/compute-agent.rst
index ae057dc9..56294770 100644
--- a/doc/source/command-objects/compute-agent.rst
+++ b/doc/source/command-objects/compute-agent.rst
@@ -80,21 +80,24 @@ Set compute agent properties
 .. code:: bash
 
     os compute agent set
-        <id> <version> <url> <md5hash>
+        [--agent-version <version>]
+        [--url <url]
+        [--md5hash <md5hash>]
+        <id>
 
 .. _compute_agent-set:
-.. describe:: <id>
+.. option:: --agent-version <version>
 
-    ID of the agent
+    Version of the agent
 
-.. describe:: <version>
+.. option:: --url <url>
 
-    Version of the agent
+    URL of the agent
 
-.. describe:: <url>
+.. option:: --md5hash <md5hash>
 
-    URL
+    MD5 hash of the agent
 
-.. describe:: <md5hash>
+.. describe:: <id>
 
-    MD5 hash
+    Agent to modify (ID only)
-- 
cgit v1.2.1