summaryrefslogtreecommitdiff
path: root/doc/source/cli/command-objects
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/cli/command-objects')
-rw-r--r--doc/source/cli/command-objects/complete.rst7
-rw-r--r--doc/source/cli/command-objects/flavor.rst12
-rw-r--r--doc/source/cli/command-objects/floating-ip.rst16
-rw-r--r--doc/source/cli/command-objects/image.rst15
-rw-r--r--doc/source/cli/command-objects/ip-floating-pool.rst16
-rw-r--r--doc/source/cli/command-objects/ip-floating.rst129
-rw-r--r--doc/source/cli/command-objects/limit.rst128
-rw-r--r--doc/source/cli/command-objects/network.rst10
-rw-r--r--doc/source/cli/command-objects/port.rst9
-rw-r--r--doc/source/cli/command-objects/registered-limit.rst140
-rw-r--r--doc/source/cli/command-objects/role.rst22
-rw-r--r--doc/source/cli/command-objects/security-group.rst74
-rw-r--r--doc/source/cli/command-objects/subnet-pool.rst8
-rw-r--r--doc/source/cli/command-objects/subnet.rst8
-rw-r--r--doc/source/cli/command-objects/versions.rst41
-rw-r--r--doc/source/cli/command-objects/volume-backend.rst8
-rw-r--r--doc/source/cli/command-objects/volume.rst8
17 files changed, 484 insertions, 167 deletions
diff --git a/doc/source/cli/command-objects/complete.rst b/doc/source/cli/command-objects/complete.rst
index 20e5c41d..165d5d07 100644
--- a/doc/source/cli/command-objects/complete.rst
+++ b/doc/source/cli/command-objects/complete.rst
@@ -11,8 +11,11 @@ Typical usage for this command is::
openstack complete | sudo tee /etc/bash_completion.d/osc.bash_completion > /dev/null
-If installing ``python-openstackclient`` from a package (``apt-get`` or ``yum``),
-then this command will likely be run for you.
+It is highly recommended to install ``python-openstackclient`` from a package
+(``apt-get`` or ``yum``). In some distributions the package ``bash-completion`` is shipped
+as dependency, and the `openstack complete` command will be run as a post-install action,
+however not every distribution include this dependency and you might need to install
+``bash-completion`` package to enable autocomplete feature.
complete
--------
diff --git a/doc/source/cli/command-objects/flavor.rst b/doc/source/cli/command-objects/flavor.rst
index 1cbd2df3..f22463b7 100644
--- a/doc/source/cli/command-objects/flavor.rst
+++ b/doc/source/cli/command-objects/flavor.rst
@@ -24,6 +24,7 @@ Create new flavor
[--property <key=value> [...] ]
[--project <project>]
[--project-domain <project-domain>]
+ [--description <description>]
<flavor-name>
.. option:: --id <id>
@@ -76,6 +77,11 @@ Create new flavor
Domain the project belongs to (name or ID).
This can be used in case collisions between project names exist.
+.. option:: --description <description>
+
+ Description to add for this flavor. Only available starting with
+ ``--os-compute-api-version 2.55``.
+
.. _flavor_create-flavor-name:
.. describe:: <flavor-name>
@@ -148,6 +154,7 @@ Set flavor properties
[--property <key=value> [...] ]
[--project <project>]
[--project-domain <project-domain>]
+ [--description <description>]
<flavor>
.. option:: --property <key=value>
@@ -168,6 +175,11 @@ Set flavor properties
Remove all properties from this flavor (specify both --no-property and --property
to remove the current properties before setting new properties.)
+.. option:: --description <description>
+
+ Description to set for this flavor. Only available starting with
+ ``--os-compute-api-version 2.55``.
+
.. describe:: <flavor>
Flavor to modify (name or ID)
diff --git a/doc/source/cli/command-objects/floating-ip.rst b/doc/source/cli/command-objects/floating-ip.rst
index c0ba7ebf..14615749 100644
--- a/doc/source/cli/command-objects/floating-ip.rst
+++ b/doc/source/cli/command-objects/floating-ip.rst
@@ -21,6 +21,8 @@ Create floating IP
[--qos-policy <qos-policy>]
[--project <project> [--project-domain <project-domain>]]
[--tag <tag> | --no-tag]
+ [--dns-domain <dns-domain>]
+ [--dns-name <dns-name>]
<network>
.. option:: --subnet <subnet>
@@ -79,6 +81,14 @@ Create floating IP
*Network version 2 only*
+.. option:: --dns-domain <dns-domain>
+
+ Set DNS domain for this floating IP (requires DNS integration extension).
+
+.. option:: --dns-name <dns-name>
+
+ Set DNS name for this floating IP (requires DNS integration extension).
+
.. describe:: <network>
Network to allocate floating IP from (name or ID)
@@ -198,7 +208,7 @@ Set floating IP properties
.. code:: bash
openstack floating ip set
- --port <port>
+ [--port <port>]
[--fixed-ip-address <ip-address>]
[--qos-policy <qos-policy> | --no-qos-policy]
[--tag <tag>] [--no-tag]
@@ -257,8 +267,8 @@ Unset floating IP Properties
.. code:: bash
openstack floating ip unset
- --port
- --qos-policy
+ [--port]
+ [--qos-policy]
[--tag <tag> | --all-tag]
<floating-ip>
diff --git a/doc/source/cli/command-objects/image.rst b/doc/source/cli/command-objects/image.rst
index f0b5bfaa..95486e33 100644
--- a/doc/source/cli/command-objects/image.rst
+++ b/doc/source/cli/command-objects/image.rst
@@ -205,10 +205,11 @@ List available images
.. code:: bash
openstack image list
- [--public | --private | --shared]
+ [--public | --private | --community | --shared]
[--property <key=value>]
[--name <name>]
[--status <status>]
+ [--tag <tag>]
[--long]
[--sort <key>[:<direction>]]
[--limit <num-images>]
@@ -222,6 +223,12 @@ List available images
List only private images
+.. option:: --community
+
+ List only community images
+
+ *Image version 2 only.*
+
.. option:: --shared
List only shared images
@@ -244,6 +251,12 @@ List available images
*Image version 2 only*
+.. option:: --tag <tag>
+
+ Filter images based on tag
+
+ *Image version 2 only*
+
.. option:: --long
List additional fields in output
diff --git a/doc/source/cli/command-objects/ip-floating-pool.rst b/doc/source/cli/command-objects/ip-floating-pool.rst
deleted file mode 100644
index 6d00355a..00000000
--- a/doc/source/cli/command-objects/ip-floating-pool.rst
+++ /dev/null
@@ -1,16 +0,0 @@
-================
-ip floating pool
-================
-
-Compute v2
-
-ip floating pool list
----------------------
-
-List pools of floating IP addresses
-(Deprecated, please use ``floating ip pool list`` instead)
-
-.. program:: ip floating pool list
-.. code:: bash
-
- openstack ip floating pool list
diff --git a/doc/source/cli/command-objects/ip-floating.rst b/doc/source/cli/command-objects/ip-floating.rst
deleted file mode 100644
index 4e5f7b00..00000000
--- a/doc/source/cli/command-objects/ip-floating.rst
+++ /dev/null
@@ -1,129 +0,0 @@
-===========
-ip floating
-===========
-
-Compute v2, Network v2
-
-ip floating add
----------------
-
-Add floating IP address to server
-(Deprecated, please use ``server add floating ip`` instead)
-
-.. program:: ip floating add
-.. code:: bash
-
- openstack ip floating add
- <ip-address>
- <server>
-
-.. describe:: <ip-address>
-
- IP address to add to server (name only)
-
-.. describe:: <server>
-
- Server to receive the IP address (name or ID)
-
-ip floating create
-------------------
-
-Create new floating IP address
-(Deprecated, please use ``floating ip create`` instead)
-
-.. program:: ip floating create
-.. code:: bash
-
- openstack ip floating create
- [--subnet <subnet>]
- [--port <port>]
- [--floating-ip-address <floating-ip-address>]
- [--fixed-ip-address <fixed-ip-address>]
- <network>
-
-.. option:: --subnet <subnet>
-
- Subnet on which you want to create the floating IP (name or ID)
- (Network v2 only)
-
-.. option:: --port <port>
-
- Port to be associated with the floating IP (name or ID)
- (Network v2 only)
-
-.. option:: --floating-ip-address <floating-ip-address>
-
- Floating IP address
- (Network v2 only)
-
-.. option:: --fixed-ip-address <fixed-ip-address>
-
- Fixed IP address mapped to the floating IP
- (Network v2 only)
-
-.. describe:: <network>
-
- Network to allocate floating IP from (name or ID)
-
-ip floating delete
-------------------
-
-Delete floating IP(s)
-(Deprecated, please use ``floating ip delete`` instead)
-
-.. program:: ip floating delete
-.. code:: bash
-
- openstack ip floating delete
- <floating-ip> [<floating-ip> ...]
-
-.. describe:: <floating-ip>
-
- Floating IP(s) to delete (IP address or ID)
-
-ip floating list
-----------------
-
-List floating IP addresses
-(Deprecated, please use ``floating ip list`` instead)
-
-.. program:: ip floating list
-.. code:: bash
-
- openstack ip floating list
-
-ip floating remove
-------------------
-
-Remove floating IP address from server
-(Deprecated, please use ``server remove floating ip`` instead)
-
-.. program:: ip floating remove
-.. code:: bash
-
- openstack ip floating remove
- <ip-address>
- <server>
-
-.. describe:: <ip-address>
-
- IP address to remove from server (name only)
-
-.. describe:: <server>
-
- Server to remove the IP address from (name or ID)
-
-ip floating show
-----------------
-
-Display floating IP details
-(Deprecated, please use ``floating ip show`` instead)
-
-.. program:: ip floating show
-.. code:: bash
-
- openstack ip floating show <floating-ip>
-
-.. describe:: <floating-ip>
-
- Floating IP to display (IP address or ID)
diff --git a/doc/source/cli/command-objects/limit.rst b/doc/source/cli/command-objects/limit.rst
new file mode 100644
index 00000000..71cf2a42
--- /dev/null
+++ b/doc/source/cli/command-objects/limit.rst
@@ -0,0 +1,128 @@
+=====
+limit
+=====
+
+Identity v3
+
+Limits are used to specify project-specific limits thresholds of resources.
+
+limit create
+------------
+
+Create a new limit
+
+.. program:: limit create
+.. code:: bash
+
+ openstack limit create
+ [--description <description>]
+ [--region <region>]
+ --project <project>
+ --service <service>
+ --resource-limit <resource-limit>
+ <resource-name>
+
+.. option:: --description <description>
+
+ Useful description of the limit or its purpose
+
+.. option:: --region <region>
+
+ Region that the limit should be applied to
+
+.. describe:: --project <project>
+
+ The project that the limit applies to (required)
+
+.. describe:: --service <service>
+
+ The service that is responsible for the resource being limited (required)
+
+.. describe:: --resource-limit <resource-limit>
+
+ The limit to apply to the project (required)
+
+.. describe:: <resource-name>
+
+ The name of the resource to limit (e.g. cores or volumes)
+
+limit delete
+------------
+
+Delete project-specific limit(s)
+
+.. program:: limit delete
+.. code:: bash
+
+ openstack limit delete
+ <limit-id> [<limit-id> ...]
+
+.. describe:: <limit-id>
+
+ Limit(s) to delete (ID)
+
+limit list
+----------
+
+List project-specific limits
+
+.. program:: limit list
+.. code:: bash
+
+ openstack limit list
+ [--service <service>]
+ [--resource-name <resource-name>]
+ [--region <region>]
+
+.. option:: --service <service>
+
+ The service to filter the response by (name or ID)
+
+.. option:: --resource-name <resource-name>
+
+ The name of the resource to filter the response by
+
+.. option:: --region <region>
+
+ The region name to filter the response by
+
+limit show
+----------
+
+Display details about a limit
+
+.. program:: limit show
+.. code:: bash
+
+ openstack limit show
+ <limit-id>
+
+.. describe:: <limit-id>
+
+ Limit to display (ID)
+
+limit set
+---------
+
+Update a limit
+
+.. program:: limit show
+.. code:: bash
+
+ openstack limit set
+ [--description <description>]
+ [--resource-limit <resource-limit>]
+ <limit-id>
+
+
+.. option:: --description <description>
+
+ Useful description of the limit or its purpose
+
+.. option:: --resource-limit <resource-limit>
+
+ The limit to apply to the project
+
+.. describe:: <limit-id>
+
+ Limit to update (ID)
diff --git a/doc/source/cli/command-objects/network.rst b/doc/source/cli/command-objects/network.rst
index 220fbf32..75113f89 100644
--- a/doc/source/cli/command-objects/network.rst
+++ b/doc/source/cli/command-objects/network.rst
@@ -33,6 +33,7 @@ Create new network
[--provider-segment <provider-segment>]
[--qos-policy <qos-policy>]
[--transparent-vlan | --no-transparent-vlan]
+ [--dns-domain <dns-domain>]
[--tag <tag> | --no-tag]
<name>
@@ -173,6 +174,10 @@ Create new network
*Network version 2 only*
+.. option:: --dns-domain <dns-domain>
+
+ Set DNS domain for this network (requires DNS integration extension).
+
.. option:: --tag <tag>
Tag to be added to the network (repeat option to set multiple tags)
@@ -367,6 +372,7 @@ Set network properties
[--provider-physical-network <provider-physical-network>]
[--provider-segment <provider-segment>]
[--qos-policy <qos-policy> | --no-qos-policy]
+ [--dns-domain <dns-domain>]
[--tag <tag>] [--no-tag]
<network>
@@ -446,6 +452,10 @@ Set network properties
Remove the QoS policy attached to this network
+.. option:: --dns-domain <dns-domain>
+
+ Set DNS domain for this network (requires DNS integration extension).
+
.. option:: --tag <tag>
Tag to be added to the network (repeat option to set multiple tags)
diff --git a/doc/source/cli/command-objects/port.rst b/doc/source/cli/command-objects/port.rst
index 335c2270..bb037fa3 100644
--- a/doc/source/cli/command-objects/port.rst
+++ b/doc/source/cli/command-objects/port.rst
@@ -179,7 +179,7 @@ List ports
[--router <router> | --server <server> | --device-id <device-id>]
[--network <network>]
[--mac-address <mac-address>]
- [--fixed-ip subnet=<subnet>,ip-address=<ip-address>]
+ [--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>]
[--long]
[--project <project> [--project-domain <project-domain>]]
[--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]]
@@ -210,10 +210,11 @@ List ports
List only ports with this MAC address
-.. option:: --fixed-ip subnet=<subnet>,ip-address=<ip-address>
+.. option:: --fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>
- Desired IP and/or subnet for filtering ports (name or ID):
- subnet=<subnet>,ip-address=<ip-address>
+ Desired IP address, IP address substring and/or subnet (name or ID) for
+ filtering ports:
+ subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>
(repeat option to set multiple fixed IP addresses)
.. option:: --long
diff --git a/doc/source/cli/command-objects/registered-limit.rst b/doc/source/cli/command-objects/registered-limit.rst
new file mode 100644
index 00000000..586fd1ff
--- /dev/null
+++ b/doc/source/cli/command-objects/registered-limit.rst
@@ -0,0 +1,140 @@
+================
+registered limit
+================
+
+Identity v3
+
+Registered limits are used to define default limits for resources within a
+deployment.
+
+registered limit create
+-----------------------
+
+Create a new registered limit
+
+.. program:: registered limit create
+.. code:: bash
+
+ openstack registered limit create
+ [--description <description>]
+ [--region <region>]
+ --service <service>
+ --default-limit <default-limit>
+ <resource-name>
+
+.. option:: --description <description>
+
+ Useful description of the registered limit or its purpose
+
+.. option:: --region <region>
+
+ Region that the limit should be applied to
+
+.. describe:: --service <service>
+
+ The service that is responsible for the resource being limited (required)
+
+.. describe:: --default-limit <default-limit>
+
+ The default limit for projects to assume unless explicitly overridden
+ (required)
+
+.. describe:: <resource-name>
+
+ The name of the resource to limit (e.g. cores or volumes)
+
+registered limit delete
+-----------------------
+
+Delete registered limit(s)
+
+.. program:: registered limit delete
+.. code:: bash
+
+ openstack registered limit delete
+ <registered-limit-id> [<registered-limit-id> ...]
+
+
+.. describe:: <registered-limit-id>
+
+ Registered limit(s) to delete (ID)
+
+registered limit list
+---------------------
+
+List registered limits
+
+.. program:: registered limit list
+.. code:: bash
+
+ openstack registered limit list
+ [--service <service>]
+ [--resource-name <resource-name>]
+ [--region <region>]
+
+.. option:: --service <service>
+
+ The service to filter the response by (name or ID)
+
+.. option:: --resource-name <resource-name>
+
+ The name of the resource to filter the response by
+
+.. option:: --region <region>
+
+ The region name to filter the response by
+
+registered limit show
+---------------------
+
+Display details about a registered limit
+
+.. program:: registered limit show
+.. code:: bash
+
+ openstack registered limit show
+ <registered-limit-id>
+
+.. describe:: <registered-limit-id>
+
+ Registered limit to display (ID)
+
+registered limit set
+--------------------
+
+Update a registered limit
+
+.. program:: registered limit set
+.. code:: bash
+
+ openstack registered limit set
+ [--service <service>]
+ [--resource-name <resource-name>]
+ [--default-limit <default-limit>]
+ [--description <description>]
+ [--region <region>]
+ <registered-limit-id>
+
+.. option:: --service <service>
+
+ The service of the registered limit to update (ID or name)
+
+.. option:: --resource-name <resource-name>
+
+ The name of the resource for the limit
+
+.. option:: --default-limit <default-limit>
+
+ The default limit for projects to assume for a given resource
+
+.. option:: --description <description>
+
+ A useful description of the limit or its purpose
+
+.. option:: --region <region>
+
+ The region the limit should apply to
+
+.. describe:: <registered-limit-id>
+
+ Registered limit to display (ID)
diff --git a/doc/source/cli/command-objects/role.rst b/doc/source/cli/command-objects/role.rst
index fe3126c0..9819fd12 100644
--- a/doc/source/cli/command-objects/role.rst
+++ b/doc/source/cli/command-objects/role.rst
@@ -13,12 +13,21 @@ Add role assignment to a user or group in a project or domain
.. code:: bash
openstack role add
- --domain <domain> | --project <project> [--project-domain <project-domain>]
+ --system <system> | --domain <domain> | --project <project> [--project-domain <project-domain>]
--user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
--role-domain <role-domain>
--inherited
<role>
+.. option:: --system <system>
+
+ Include <system>
+
+ System or service to grant authorization to. Currently only ``all`` is
+ supported which encompasses the entire deployment system.
+
+ .. versionadded:: 3
+
.. option:: --domain <domain>
Include <domain> (name or ID)
@@ -210,12 +219,21 @@ Remove role assignment from domain/project : user/group
.. code:: bash
openstack role remove
- --domain <domain> | --project <project> [--project-domain <project-domain>]
+ --system <system> | --domain <domain> | --project <project> [--project-domain <project-domain>]
--user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
--role-domain <role-domain>
--inherited
<role>
+.. option:: --system <system>
+
+ Include <system>
+
+ System or service to remove authorization from. Currently only ``all`` is
+ supported which encompasses the entire deployment system.
+
+ .. versionadded:: 3
+
.. option:: --domain <domain>
Include <domain> (name or ID)
diff --git a/doc/source/cli/command-objects/security-group.rst b/doc/source/cli/command-objects/security-group.rst
index a95a96f4..403e5fc0 100644
--- a/doc/source/cli/command-objects/security-group.rst
+++ b/doc/source/cli/command-objects/security-group.rst
@@ -19,6 +19,7 @@ Create a new security group
openstack security group create
[--description <description>]
[--project <project> [--project-domain <project-domain>]]
+ [--tag <tag> | --no-tag]
<name>
.. option:: --description <description>
@@ -38,6 +39,18 @@ Create a new security group
*Network version 2 only*
+.. option:: --tag <tag>
+
+ Tag to be added to the security group (repeat option to set multiple tags)
+
+ *Network version 2 only*
+
+.. option:: --no-tag
+
+ No tags associated with the security group
+
+ *Network version 2 only*
+
.. describe:: <name>
New security group name
@@ -68,6 +81,8 @@ List security groups
openstack security group list
[--all-projects]
[--project <project> [--project-domain <project-domain>]]
+ [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]]
+ [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
.. option:: --all-projects
@@ -89,6 +104,30 @@ List security groups
*Network version 2 only*
+.. option:: --tags <tag>[,<tag>,...]
+
+ List security groups which have all given tag(s)
+
+ *Network version 2 only*
+
+.. option:: --any-tags <tag>[,<tag>,...]
+
+ List security groups which have any given tag(s)
+
+ *Network version 2 only*
+
+.. option:: --not-tags <tag>[,<tag>,...]
+
+ Exclude security groups which have all given tag(s)
+
+ *Network version 2 only*
+
+.. option:: --not-any-tags <tag>[,<tag>,...]
+
+ Exclude security groups which have any given tag(s)
+
+ *Network version 2 only*
+
security group set
------------------
@@ -100,6 +139,7 @@ Set security group properties
openstack security group set
[--name <new-name>]
[--description <description>]
+ [--tag <tag>] [--no-tag]
<group>
.. option:: --name <new-name>
@@ -110,6 +150,15 @@ Set security group properties
New security group description
+.. option:: --tag <tag>
+
+ Tag to be added to the security group (repeat option to set multiple tags)
+
+.. option:: --no-tag
+
+ Clear tags associated with the security group. Specify both --tag
+ and --no-tag to overwrite current tags
+
.. describe:: <group>
Security group to modify (name or ID)
@@ -128,3 +177,28 @@ Display security group details
.. describe:: <group>
Security group to display (name or ID)
+
+security group unset
+--------------------
+
+Unset security group properties
+
+.. program:: security group unset
+.. code:: bash
+
+ openstack security group unset
+ [--tag <tag> | --all-tag]
+ <group>
+
+.. option:: --tag <tag>
+
+ Tag to be removed from the security group
+ (repeat option to remove multiple tags)
+
+.. option:: --all-tag
+
+ Clear all tags associated with the security group
+
+.. describe:: <group>
+
+ Security group to modify (name or ID)
diff --git a/doc/source/cli/command-objects/subnet-pool.rst b/doc/source/cli/command-objects/subnet-pool.rst
index 0cff4d7f..c6fda03c 100644
--- a/doc/source/cli/command-objects/subnet-pool.rst
+++ b/doc/source/cli/command-objects/subnet-pool.rst
@@ -77,8 +77,8 @@ Create subnet pool
.. option:: --default-quota <num-ip-addresses>
- Set default quota for subnet pool as the number of
- IP addresses allowed in a subnet
+ Set default per-project quota for this subnet pool as the number of
+ IP addresses that can be allocated from the subnet pool
.. option:: --tag <tag>
@@ -250,8 +250,8 @@ Set subnet pool properties
.. option:: --default-quota <num-ip-addresses>
- Set default quota for subnet pool as the number of
- IP addresses allowed in a subnet
+ Set default per-project quota for this subnet pool as the number of
+ IP addresses that can be allocated from the subnet pool
.. option:: --tag <tag>
diff --git a/doc/source/cli/command-objects/subnet.rst b/doc/source/cli/command-objects/subnet.rst
index 0a56ccf1..73e656d8 100644
--- a/doc/source/cli/command-objects/subnet.rst
+++ b/doc/source/cli/command-objects/subnet.rst
@@ -265,6 +265,7 @@ Set subnet properties
[--dns-nameserver <dns-nameserver>]
[--no-dns-nameserver]
[--gateway <gateway-ip>]
+ [--network-segment <network-segment>]
[--host-route destination=<subnet>,gateway=<ip-address>]
[--no-host-route]
[--service-type <service-type>]
@@ -310,6 +311,13 @@ Set subnet properties
'none': This subnet will not use a gateway,
e.g.: ``--gateway 192.168.9.1``, ``--gateway none``.
+.. option:: --network-segment <network-segment>
+
+ Network segment to associate with this subnet (name or ID). It is only
+ allowed to set the segment if the current value is `None`, the network
+ must also have only one segment and only one subnet can exist on the
+ network.
+
.. option:: --host-route destination=<subnet>,gateway=<ip-address>
Additional route for this subnet e.g.:
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/
diff --git a/doc/source/cli/command-objects/volume-backend.rst b/doc/source/cli/command-objects/volume-backend.rst
new file mode 100644
index 00000000..0285d61b
--- /dev/null
+++ b/doc/source/cli/command-objects/volume-backend.rst
@@ -0,0 +1,8 @@
+==============
+volume backend
+==============
+
+Volume v2
+
+.. autoprogram-cliff:: openstack.volume.v2
+ :command: volume backend *
diff --git a/doc/source/cli/command-objects/volume.rst b/doc/source/cli/command-objects/volume.rst
index fd704b04..5c86d10d 100644
--- a/doc/source/cli/command-objects/volume.rst
+++ b/doc/source/cli/command-objects/volume.rst
@@ -15,7 +15,7 @@ Create new volume
openstack volume create
[--size <size>]
[--type <volume-type>]
- [--image <image> | --snapshot <snapshot> | --source <volume> | --source-replicated <replicated-volume>]
+ [--image <image> | --snapshot <snapshot> | --source <volume> ]
[--description <description>]
[--user <user>]
[--project <project>]
@@ -31,7 +31,7 @@ Create new volume
.. option:: --size <size>
Volume size in GB
- (Required unless --snapshot or --source or --source-replicated is specified)
+ (Required unless --snapshot or --source is specified)
.. option:: --type <volume-type>
@@ -54,10 +54,6 @@ Create new volume
Volume to clone (name or ID)
-.. option:: --source-replicated <replicated-volume>
-
- Replicated volume to clone (name or ID)
-
.. option:: --description <description>
Volume description