Merge "Add command to show all service versions"

1 files changed, 41 insertions, 0 deletions

diff --git a/doc/source/cli/command-objects/versions.rst b/doc/source/cli/command-objects/versions.rst
new file mode 100644
index 00000000..67425652
--- /dev/null
+++ b/doc/source/cli/command-objects/versions.rst
@@ -0,0 +1,41 @@
+========
+versions
+========
+
+Get a list of every version of every service in a given cloud.
+
+versions show
+-------------
+
+Show service versions:
+
+.. program:: versions show
+.. code:: bash
+
+    openstack versions show
+        [--all-interfaces]
+        [--interface <interface>]
+        [--region-name <region-name>]
+        [--service <service>]
+
+.. option:: --all-interfaces
+
+    Return results for every interface of every service.
+    [Mutually exclusive with --interface]
+
+.. option:: --interface <interface>
+
+    Limit results to only those on given interface.
+    [Default 'public'. Mutually exclusive with --all-interfaces]
+
+.. option:: --region-name <region-name>
+
+    Limit results to only those from region-name
+
+.. option:: --service <service>
+
+    Limit results to only those for service. The argument should be either
+    an exact match to what is in the catalog or a known official value or
+    alias from `service-types-authority`_.
+
+.. _service-types-authority: https://service-types.openstack.org/