2820b9a6d6
This patch moves the "disable a service" section to a different section in the admin guide to improve the IA. Change-Id: I5be588d8d76798b12318d42a86206d348df2a3c9 Closes-Bug: #1602367 Implements: blueprint user-guide-editing
138 lines
3.6 KiB
ReStructuredText
138 lines
3.6 KiB
ReStructuredText
===================================
|
|
Manage Block Storage service quotas
|
|
===================================
|
|
|
|
As an administrative user, you can update the OpenStack Block
|
|
Storage service quotas for a project. You can also update the quota
|
|
defaults for a new project.
|
|
|
|
**Block Storage quotas**
|
|
|
|
=================== =============================================
|
|
Property name Defines the number of
|
|
=================== =============================================
|
|
gigabytes Volume gigabytes allowed for each project.
|
|
snapshots Volume snapshots allowed for each project.
|
|
volumes Volumes allowed for each project.
|
|
=================== =============================================
|
|
|
|
View Block Storage quotas
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Administrative users can view Block Storage service quotas.
|
|
|
|
#. Obtain the project ID.
|
|
|
|
For example:
|
|
|
|
.. code-block:: console
|
|
|
|
$ project_id=$(openstack project show -f value -c id PROJECT_NAME)
|
|
|
|
#. List the default quotas for a project (tenant):
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-defaults PROJECT_ID
|
|
|
|
For example:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-defaults $project_id
|
|
+-----------+-------+
|
|
| Property | Value |
|
|
+-----------+-------+
|
|
| gigabytes | 1000 |
|
|
| snapshots | 10 |
|
|
| volumes | 10 |
|
|
+-----------+-------+
|
|
|
|
#. View Block Storage service quotas for a project (tenant):
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-show PROJECT_ID
|
|
|
|
For example:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-show $project_id
|
|
+-----------+-------+
|
|
| Property | Value |
|
|
+-----------+-------+
|
|
| gigabytes | 1000 |
|
|
| snapshots | 10 |
|
|
| volumes | 10 |
|
|
+-----------+-------+
|
|
|
|
#. Show the current usage of a per-project quota:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-usage PROJECT_ID
|
|
|
|
For example:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-usage $project_id
|
|
+-----------+--------+----------+-------+
|
|
| Type | In_use | Reserved | Limit |
|
|
+-----------+--------+----------+-------+
|
|
| gigabytes | 0 | 0 | 1000 |
|
|
| snapshots | 0 | 0 | 10 |
|
|
| volumes | 0 | 0 | 15 |
|
|
+-----------+--------+----------+-------+
|
|
|
|
Edit and update Block Storage service quotas
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Administrative users can edit and update Block Storage
|
|
service quotas.
|
|
|
|
#. Clear per-project quota limits.
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-delete PROJECT_ID
|
|
|
|
#. To update a default value for a new project,
|
|
update the property in the :guilabel:`cinder.quota`
|
|
section of the ``/etc/cinder/cinder.conf`` file.
|
|
For more information, see the `Block Storage service
|
|
<http://docs.openstack.org/mitaka/config-reference/block-storage.html>`_
|
|
in OpenStack Configuration Reference.
|
|
|
|
#. To update Block Storage service quotas for an existing project (tenant)
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-update --QUOTA_NAME QUOTA_VALUE PROJECT_ID
|
|
|
|
Replace QUOTA_NAME with the quota that is to be updated, NEW_VALUE
|
|
with the required new value, and PROJECT_ID with required project
|
|
ID.
|
|
|
|
For example:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-update --volumes 15 $project_id
|
|
$ cinder quota-show $project_id
|
|
+-----------+-------+
|
|
| Property | Value |
|
|
+-----------+-------+
|
|
| gigabytes | 1000 |
|
|
| snapshots | 10 |
|
|
| volumes | 15 |
|
|
+-----------+-------+
|
|
|
|
|
|
#. Clear per-project quota limits.
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder quota-delete PROJECT_ID
|