python-openstackclient/doc/source/command-objects/aggregate.rst
zhiyong.dai 75f2875a6e Add ":option: " in the help message
This patch mainly adds  ":option:` `" in several help messages in the doc.
This modification will create one link which helps the readers find the relative
option quickly and conveniently in website.

Change-Id: Ia047e15c3b2064e4822ee7df7922d4774d862602
2017-01-03 12:13:10 +08:00

187 lines
3.4 KiB
ReStructuredText

=========
aggregate
=========
Host aggregates provide a mechanism to group hosts according to certain
criteria.
Compute v2
aggregate add host
------------------
Add host to aggregate
.. program:: aggregate add host
.. code:: bash
openstack aggregate add host
<aggregate>
<host>
.. _aggregate_add_host-aggregate:
.. describe:: <aggregate>
Aggregate (name or ID)
.. _aggregate_add_host-host:
.. describe:: <host>
Host to add to :ref:`\<aggregate\> <aggregate_add_host-aggregate>`
aggregate create
----------------
Create a new aggregate
.. program:: aggregate create
.. code:: bash
openstack aggregate create
[--zone <availability-zone>]
[--property <key=value> [...] ]
<name>
.. option:: --zone <availability-zone>
Availability zone name
.. option:: --property <key=value>
Property to add to this aggregate (repeat option to set multiple properties)
.. _aggregate_create-name:
.. describe:: <name>
New aggregate name
aggregate delete
----------------
Delete existing aggregate(s)
.. program:: aggregate delete
.. code:: bash
openstack aggregate delete
<aggregate> [<aggregate> ...]
.. _aggregate_delete-aggregate:
.. describe:: <aggregate>
Aggregate(s) to delete (name or ID)
aggregate list
--------------
List all aggregates
.. program:: aggregate list
.. code:: bash
openstack aggregate list
[--long]
.. option:: --long
List additional fields in output
aggregate remove host
---------------------
Remove host from aggregate
.. program:: aggregate remove host
.. code:: bash
openstack aggregate remove host
<aggregate>
<host>
.. _aggregate_remove_host-aggregate:
.. describe:: <aggregate>
Aggregate (name or ID)
.. _aggregate_remove_host-host:
.. describe:: <host>
Host to remove from :ref:`\<aggregate\> <aggregate_remove_host-aggregate>`
aggregate set
-------------
Set aggregate properties
.. program:: aggregate set
.. code:: bash
openstack aggregate set
[--name <new-name>]
[--zone <availability-zone>]
[--property <key=value> [...] ]
[--no-property]
<aggregate>
.. option:: --name <name>
Set aggregate name
.. option:: --zone <availability-zone>
Set availability zone name
.. option:: --property <key=value>
Property to set on :ref:`\<aggregate\> <aggregate_set-aggregate>`
(repeat option to set multiple properties)
.. option:: --no-property
Remove all properties from :ref:`\<aggregate\> <aggregate_set-aggregate>`
(specify both :option:`--property` and :option:`--no-property` to
overwrite the current properties)
.. _aggregate_set-aggregate:
.. describe:: <aggregate>
Aggregate to modify (name or ID)
aggregate show
--------------
Display aggregate details
.. program:: aggregate show
.. code:: bash
openstack aggregate show
<aggregate>
.. _aggregate_show-aggregate:
.. describe:: <aggregate>
Aggregate to display (name or ID)
aggregate unset
---------------
Unset aggregate properties
.. program:: aggregate unset
.. code-block:: bash
openstack aggregate unset
[--property <key> [...] ]
<aggregate>
.. option:: --property <key>
Property to remove from :ref:`\<aggregate\> <aggregate_unset-aggregate>`
(repeat option to remove multiple properties)
.. _aggregate_unset-aggregate:
.. describe:: <aggregate>
Aggregate to modify (name or ID)