openstack/cinder
Code Issues Proposed changes
cinder/doc/source/cli/cli-cinder-quotas.rst
Jay S. Bryant 1423480fb6 Make doc/source directory compliant with design in spec 
The following spec defines what each project's doc/source
directory is supposed to look like:

https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

I had not yet moved existing content to follow this design.
This patch does that, moving the devref to the
'contributor' directory.  It also moves the CLI
related documentation into the 'cli' directory.  I have
updated the autodoc generation to now create the api
documentation in 'doc/source/contributor/api'.

This patch also creates a template for future documentation
contribution.  I have created all of the directories
recommended by the spec and have included documentation
as to what should go in each directory.

The index file is updated to point at the new locations for
existing content.

'doc/.gitignore' is updated so that it won't complain about the
automatically generated 'doc/contributor/api' directory.

Change-Id: I55c50fa0b7c1d06c91e40dbcfd11b1c8e8378aa6
2017-07-19 15:59:02 -05:00

9.6 KiB
Raw Blame History

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.

  1. Obtain the project ID:

    $ project_id=$(openstack project show -f value -c id PROJECT_NAME)

  2. List the default quotas for a project:

    $ openstack quota show --default $OS_TENANT_ID
+-----------------------+-------+
| Field                 | Value |
+-----------------------+-------+
| backup-gigabytes      | 1000  |
| backups               | 10    |
| cores                 | 20    |
| fixed-ips             | -1    |
| floating-ips          | 50    |
| gigabytes             | 1000  |
| gigabytes_lvmdriver-1 | -1    |
| health_monitors       | None  |
| injected-file-size    | 10240 |
| injected-files        | 5     |
| injected-path-size    | 255   |
| instances             | 10    |
| key-pairs             | 100   |
| l7_policies           | None  |
| listeners             | None  |
| load_balancers        | None  |
| location              | None  |
| name                  | None  |
| networks              | 10    |
| per-volume-gigabytes  | -1    |
| pools                 | None  |
| ports                 | 50    |
| project               | None  |
| project_id            | None  |
| properties            | 128   |
| ram                   | 51200 |
| rbac_policies         | 10    |
| routers               | 10    |
| secgroup-rules        | 100   |
| secgroups             | 10    |
| server-group-members  | 10    |
| server-groups         | 10    |
| snapshots             | 10    |
| snapshots_lvmdriver-1 | -1    |
| subnet_pools          | -1    |
| subnets               | 10    |
| volumes               | 10    |
| volumes_lvmdriver-1   | -1    |
+-----------------------+-------+

Note

Listing default quotas with the OpenStack command line client will provide all quotas for storage and network services. Previously, the cinder quota-defaults command would list only storage quotas. You can use PROJECT_ID or $OS_TENANT_NAME arguments to show Block Storage service quotas. If the PROJECT_ID argument returns errors in locating resources, use $OS_TENANT_NAME.

  1. View Block Storage service quotas for a project:

    $ openstack quota show $OS_TENANT_ID
+-----------------------+-------+
| Field                 | Value |
+-----------------------+-------+
| backup-gigabytes      | 1000  |
| backups               | 10    |
| cores                 | 20    |
| fixed-ips             | -1    |
| floating-ips          | 50    |
| gigabytes             | 1000  |
| gigabytes_lvmdriver-1 | -1    |
| health_monitors       | None  |
| injected-file-size    | 10240 |
| injected-files        | 5     |
| injected-path-size    | 255   |
| instances             | 10    |
| key-pairs             | 100   |
| l7_policies           | None  |
| listeners             | None  |
| load_balancers        | None  |
| location              | None  |
| name                  | None  |
| networks              | 10    |
| per-volume-gigabytes  | -1    |
| pools                 | None  |
| ports                 | 50    |
| project               | None  |
| project_id            | None  |
| properties            | 128   |
| ram                   | 51200 |
| rbac_policies         | 10    |
| routers               | 10    |
| secgroup-rules        | 100   |
| secgroups             | 10    |
| server-group-members  | 10    |
| server-groups         | 10    |
| snapshots             | 10    |
| snapshots_lvmdriver-1 | -1    |
| subnet_pools          | -1    |
| subnets               | 10    |
| volumes               | 10    |
| volumes_lvmdriver-1   | -1    |
+-----------------------+-------+

  2. Show the current usage of a per-project quota:

    $ cinder quota-usage $project_id
+-----------------------+--------+----------+-------+
| Type                  | In_use | Reserved | Limit |
+-----------------------+--------+----------+-------+
| backup_gigabytes      | 0      | 0        | 1000  |
| backups               | 0      | 0        | 10    |
| gigabytes             | 0      | 0        | 1000  |
| gigabytes_lvmdriver-1 | 0      | 0        | -1    |
| per_volume_gigabytes  | 0      | 0        | -1    |
| snapshots             | 0      | 0        | 10    |
| snapshots_lvmdriver-1 | 0      | 0        | -1    |
| volumes               | 0      | 0        | 10    |
| volumes_lvmdriver-1   | 0      | 0        | -1    |
+-----------------------+--------+----------+-------+

Edit and update Block Storage service quotas

Administrative users can edit and update Block Storage service quotas.

  1. To update a default value for a new project, update the property in the cinder.quota section of the /etc/cinder/cinder.conf file. For more information, see the Block Storage service in OpenStack Configuration Reference.

  2. To update Block Storage service quotas for an existing project

    $ openstack quota set --QUOTA_NAME QUOTA_VALUE PROJECT_ID

    Replace QUOTA_NAME with the quota that is to be updated, QUOTA_VALUE with the required new value. Use the openstack quota show command with PROJECT_ID, which is the required project ID.

    For example:

    $ openstack quota set --volumes 15  $project_id
$ openstack quota show $project_id
+-----------------------+----------------------------------+
| Field                 | Value                            |
+-----------------------+----------------------------------+
| backup-gigabytes      | 1000                             |
| backups               | 10                               |
| cores                 | 20                               |
| fixed-ips             | -1                               |
| floating-ips          | 29                               |
| gigabytes             | 1000                             |
| gigabytes_lvmdriver-1 | -1                               |
| health_monitors       | None                             |
| injected-file-size    | 10240                            |
| injected-files        | 5                                |
| injected-path-size    | 255                              |
| instances             | 10                               |
| key-pairs             | 100                              |
| l7_policies           | None                             |
| listeners             | None                             |
| load_balancers        | None                             |
| location              | None                             |
| name                  | None                             |
| networks              | 10                               |
| per-volume-gigabytes  | -1                               |
| pools                 | None                             |
| ports                 | 50                               |
| project               | e436339c7f9c476cb3120cf3b9667377 |
| project_id            | None                             |
| properties            | 128                              |
| ram                   | 51200                            |
| rbac_policies         | 10                               |
| routers               | 10                               |
| secgroup-rules        | 100                              |
| secgroups             | 10                               |
| server-group-members  | 10                               |
| server-groups         | 10                               |
| snapshots             | 10                               |
| snapshots_lvmdriver-1 | -1                               |
| subnet_pools          | -1                               |
| subnets               | 10                               |
| volumes               | 15                               |
| volumes_lvmdriver-1   | -1                               |
+-----------------------+----------------------------------+

  3. To clear per-project quota limits:

    $ cinder quota-delete PROJECT_ID