DocImpact: Add quotas per share type

Add docs for implementation of quotas per share type

Change-Id: I7d2b87c9e1055a6fb9a8dc50ae17769fa17dc3ee
Closes-Bug: #1705540
This commit is contained in:
junboli 2017-12-27 15:44:45 +08:00 committed by junbo.li
parent 7ef7633c08
commit cb6556ffcb
2 changed files with 62 additions and 27 deletions

View File

@ -101,9 +101,10 @@ you get the quotas for the specified project.
.. code-block:: console .. code-block:: console
$ manila quota-show --tenant %project_id% --user %user_id% $ manila quota-show --tenant %project_id% --user %user_id%
+-----------------------+-------+ +-----------------------+-----------------------------------+
| Property | Value | | Property | Value |
+-----------------------+-------+ +-----------------------+-----------------------------------+
| id | d99c76b43b1743fd822d26ccc915989c |
| gigabytes | 1000 | | gigabytes | 1000 |
| snapshot_gigabytes | 1000 | | snapshot_gigabytes | 1000 |
| snapshots | 50 | | snapshots | 50 |
@ -111,7 +112,7 @@ you get the quotas for the specified project.
| share_networks | 10 | | share_networks | 10 |
| share_groups | 50 | | share_groups | 50 |
| share_group_snapshots | 50 | | share_group_snapshots | 50 |
+-----------------------+-------+ +-----------------------+-----------------------------------+
There are default quotas for a project that are set from the There are default quotas for a project that are set from the
``manila.conf`` file. To list the default quotas for a project, use ``manila.conf`` file. To list the default quotas for a project, use
@ -120,9 +121,10 @@ the :command:`manila quota-defaults` command:
.. code-block:: console .. code-block:: console
$ manila quota-defaults --tenant %project_id% $ manila quota-defaults --tenant %project_id%
+-----------------------+-------+ +-----------------------+------------------------------------+
| Property | Value | | Property | Value |
+-----------------------+-------+ +-----------------------+------------------------------------+
| id | 1cc2154937bd40f4815d5f168d372263 |
| gigabytes | 1000 | | gigabytes | 1000 |
| snapshot_gigabytes | 1000 | | snapshot_gigabytes | 1000 |
| snapshots | 50 | | snapshots | 50 |
@ -130,13 +132,13 @@ the :command:`manila quota-defaults` command:
| share_networks | 10 | | share_networks | 10 |
| share_groups | 50 | | share_groups | 50 |
| share_group_snapshots | 50 | | share_group_snapshots | 50 |
+-----------------------+-------+ +-----------------------+------------------------------------+
The administrator can update the quotas for a specific project, or for a The administrator can update the quotas for a specific project, or for a
specific user by providing both the ``--tenant`` and ``--user`` optional specific user by providing both the ``--tenant`` and ``--user`` optional
arguments. It is possible to update the ``shares``, ``snapshots``, arguments. It is possible to update the ``shares``, ``snapshots``,
``gigabytes``, ``snapshot-gigabytes``, ``share-networks``, ``share_groups`` ``gigabytes``, ``snapshot-gigabytes``, ``share-networks``, ``share_groups``,
and ``share_group_snapshots`` quotas. ``share_group_snapshots`` and ``share-type`` quotas.
.. code-block:: console .. code-block:: console
@ -150,8 +152,24 @@ To force-update a quota, use ``force`` optional key.
$ manila quota-update %project_id% --shares 51 --snapshots 51 --force $ manila quota-update %project_id% --shares 51 --snapshots 51 --force
The administrator can also update the quotas for a specific share type. Share
Type quotas cannot be set for individual users within a project. They can only
be applied across all users of a particular project.
.. code-block:: console
$ manila quota-update %project_id% --share-type %share_type_id%
To revert quotas to default for a project or for a user, delete quotas: To revert quotas to default for a project or for a user, delete quotas:
.. code-block:: console .. code-block:: console
$ manila quota-delete --tenant %project_id% --user %user_id% $ manila quota-delete --tenant %project_id% --user-id %user_id%
To revert quotas to default, use the specific project or share type. Share
Type quotas can not be reverted for individual users within a project. They
can only be reverted across all users of a particular project.
.. code-block:: console
$ manila quota-delete --tenant %project_id% --share-type %share_type_id%

View File

@ -1286,6 +1286,7 @@ manila quota-delete
.. code-block:: console .. code-block:: console
usage: manila quota-delete [--tenant <tenant-id>] [--user <user-id>] usage: manila quota-delete [--tenant <tenant-id>] [--user <user-id>]
[--share-type <share-type>]
Delete quota for a tenant/user. The quota will revert back to default (Admin Delete quota for a tenant/user. The quota will revert back to default (Admin
only). only).
@ -1298,6 +1299,11 @@ only).
``--user <user-id>`` ``--user <user-id>``
ID of user to delete quota for. ID of user to delete quota for.
``--share-type <share-type>, --share_type <share-type>``
UUID or name of a share type to set the quotas for.
Optional. Mutually exclusive with '--user-id'.
Available only for microversion >= 2.39
.. _manila_quota-show: .. _manila_quota-show:
manila quota-show manila quota-show
@ -1305,7 +1311,8 @@ manila quota-show
.. code-block:: console .. code-block:: console
usage: manila quota-show [--tenant <tenant-id>] [--user <user-id>] [--detail] usage: manila quota-show [--tenant <tenant-id>] [--user <user-id>]
[--share-type <share-type>] [--detail]
List the quotas for a tenant/user. List the quotas for a tenant/user.
@ -1317,6 +1324,11 @@ List the quotas for a tenant/user.
``--user <user-id>`` ``--user <user-id>``
ID of user to list the quotas for. ID of user to list the quotas for.
``--share-type <share-type>, --share_type <share-type>``
UUID or name of a share type to set the quotas for.
Optional. Mutually exclusive with '--user-id'.
Available only for microversion >= 2.39
``--detail`` ``--detail``
Optional flag to indicate whether to show quota in Optional flag to indicate whether to show quota in
detail. Default false, available only for microversion detail. Default false, available only for microversion
@ -1335,7 +1347,7 @@ manila quota-update
[--share-networks <share-networks>] [--share-networks <share-networks>]
[--share-groups <share-groups>] [--share-groups <share-groups>]
[--share-group-snapshots <share-group-snapshots>] [--share-group-snapshots <share-group-snapshots>]
[--force] [--share-type <share-type>] [--force]
<tenant_id> <tenant_id>
Update the quotas for a tenant/user (Admin only). Update the quotas for a tenant/user (Admin only).
@ -1371,6 +1383,11 @@ Update the quotas for a tenant/user (Admin only).
``--share-group-snapshots <share-group-snapshots>, --share_group_snapshots <share-group-snapshots>`` ``--share-group-snapshots <share-group-snapshots>, --share_group_snapshots <share-group-snapshots>``
New value for the "share_group_snapshots" quota. New value for the "share_group_snapshots" quota.
``--share-type <share-type>, --share_type <share-type>``
UUID or name of a share type to set the quotas for.
Optional. Mutually exclusive with '--user-id'.
Available only for microversion >= 2.39
``--force`` ``--force``
Whether force update the quota even if the already Whether force update the quota even if the already
used and reserved exceeds the new quota. used and reserved exceeds the new quota.