summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.opendev.org>2019-09-25 04:01:51 +0000
committerGerrit Code Review <review@openstack.org>2019-09-25 04:01:51 +0000
commit3fe5d27a4df00280d00cc9041b99911b3d576eef (patch)
tree339b3b55577aa75a8f339fbfb061cb95354ffbe2
parent1775342190bcaf9118f244623eda96170f9a2283 (diff)
parent72922ae1a1b842b1a5058377f8033cbf09086b4c (diff)
downloadpython-openstackclient-rocky-em.tar.gz
Merge "Document 2.53 behavior for compute service list/delete" into stable/rockyrocky-em3.16.3
-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 ba624ea0..0977a0e8 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 b289a4f8..cefac39c 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)