Stephen Finucane 629eb33c4d volume: Add 'volume qos set --no-property' option
Supporting "--no-property" option will apply user a convenient way to
clean all properties of volume qos in a short command. The patch adds
"--no-property" option in "volume qos set" command and update related
test cases and docs.

Change-Id: I1fb5b4f0a923bbf557a3af3f63809bde9e84ffd4
2023-05-17 16:50:16 +01:00

174 lines
3.4 KiB
ReStructuredText

==========
volume qos
==========
Block Storage v1, v2
volume qos associate
--------------------
Associate a QoS specification to a volume type
.. program:: volume qos associate
.. code:: bash
openstack volume qos associate
<qos-spec>
<volume-type>
.. _volume_qos_associate:
.. describe:: <qos-spec>
QoS specification to modify (name or ID)
.. describe:: <volume-type>
Volume type to associate the QoS (name or ID)
volume qos create
-----------------
Create new QoS Specification
.. program:: volume qos create
.. code:: bash
openstack volume qos create
[--consumer <consumer>]
[--property <key=value> [...] ]
<name>
.. option:: --consumer <consumer>
Consumer of the QoS. Valid consumers: 'front-end', 'back-end', 'both' (defaults to 'both')
.. option:: --property <key=value>
Set a property on this QoS specification (repeat option to set multiple properties)
.. _volume_qos_create-name:
.. describe:: <name>
New QoS specification name
volume qos delete
-----------------
Delete QoS specification
.. program:: volume qos delete
.. code:: bash
openstack volume qos delete
[--force]
<qos-spec> [<qos-spec> ...]
.. option:: --force
Allow to delete in-use QoS specification(s)
.. _volume_qos_delete-qos-spec:
.. describe:: <qos-spec>
QoS specification(s) to delete (name or ID)
volume qos disassociate
-----------------------
Disassociate a QoS specification from a volume type
.. program:: volume qos disassociate
.. code:: bash
openstack volume qos disassociate
--volume-type <volume-type> | --all
<qos-spec>
.. option:: --volume-type <volume-type>
Volume type to disassociate the QoS from (name or ID)
.. option:: --all
Disassociate the QoS from every volume type
.. _volume_qos_disassociate-qos-spec:
.. describe:: <qos-spec>
QoS specification to modify (name or ID)
volume qos list
---------------
List QoS specifications
.. program:: volume qos list
.. code:: bash
openstack volume qos list
volume qos set
--------------
Set QoS specification properties
.. program:: volume qos set
.. code:: bash
openstack volume qos set
[--no-property]
[--property <key=value> [...] ]
<qos-spec>
.. option:: --no-property
Remove all properties from :ref:`\<snapshot\> <volume_qos_set-qos-spec>`
(specify both :option:`--no-property` and :option:`--property` to
remove the current properties before setting new properties.)
.. option:: --property <key=value>
Property to add or modify for this QoS specification (repeat option to set multiple properties)
.. _volume_qos_set-qos-spec:
.. describe:: <qos-spec>
QoS specification to modify (name or ID)
volume qos show
---------------
Display QoS specification details
.. program:: volume qos show
.. code:: bash
openstack volume qos show
<qos-spec>
.. _volume_qos_show-qos-spec:
.. describe:: <qos-spec>
QoS specification to display (name or ID)
volume qos unset
----------------
Unset QoS specification properties
.. program:: volume qos unset
.. code:: bash
openstack volume qos unset
[--property <key> [...] ]
<qos-spec>
.. option:: --property <key>
Property to remove from QoS specification (repeat option to remove multiple properties)
.. _volume_qos_unset-qos-spec:
.. describe:: <qos-spec>
QoS specification to modify (name or ID)