summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.opendev.org>2019-08-22 21:39:51 +0000
committerGerrit Code Review <review@openstack.org>2019-08-22 21:39:51 +0000
commit0001404d7dc8e00877ab2e35992e89a42908d71f (patch)
tree8b71b56d2c692a01830d7caa4ee5b061f2fe51d4
parenta15e4741fa1c02e3e87ce072cfee2b19f9279924 (diff)
parent1557afb554e908e097abd39081891ea78083e20e (diff)
downloadpython-openstackclient-0001404d7dc8e00877ab2e35992e89a42908d71f.tar.gz
Merge "Document 2.53 behavior for compute service list/delete"
-rw-r--r--doc/source/cli/command-objects/compute-service.rst8
-rw-r--r--openstackclient/compute/v2/service.py11
2 files changed, 16 insertions, 3 deletions
diff --git a/doc/source/cli/command-objects/compute-service.rst b/doc/source/cli/command-objects/compute-service.rst
index 45e781e2..a76a9c26 100644
--- a/doc/source/cli/command-objects/compute-service.rst
+++ b/doc/source/cli/command-objects/compute-service.rst
@@ -18,13 +18,19 @@ Delete compute service(s)
.. _compute_service_delete-service:
.. describe:: <service>
- Compute service(s) to delete (ID only)
+ Compute service(s) to delete (ID only). If using
+ ``--os-compute-api-version`` 2.53 or greater, the ID is a UUID which can
+ be retrieved by listing compute services using the same 2.53+ microversion.
compute service list
--------------------
List compute services
+Using ``--os-compute-api-version`` 2.53 or greater will return the ID as a
+UUID value which can be used to uniquely identify the service in a multi-cell
+deployment.
+
.. program:: compute service list
.. code:: bash
diff --git a/openstackclient/compute/v2/service.py b/openstackclient/compute/v2/service.py
index 80c0be7e..625c0fad 100644
--- a/openstackclient/compute/v2/service.py
+++ b/openstackclient/compute/v2/service.py
@@ -37,7 +37,10 @@ class DeleteService(command.Command):
"service",
metavar="<service>",
nargs='+',
- help=_("Compute service(s) to delete (ID only)")
+ help=_("Compute service(s) to delete (ID only). If using "
+ "``--os-compute-api-version`` 2.53 or greater, the ID is "
+ "a UUID which can be retrieved by listing compute services "
+ "using the same 2.53+ microversion.")
)
return parser
@@ -60,7 +63,11 @@ class DeleteService(command.Command):
class ListService(command.Lister):
- _description = _("List compute services")
+ _description = _("List compute services. Using "
+ "``--os-compute-api-version`` 2.53 or greater will "
+ "return the ID as a UUID value which can be used to "
+ "uniquely identify the service in a multi-cell "
+ "deployment.")
def get_parser(self, prog_name):
parser = super(ListService, self).get_parser(prog_name)