Manage Block Storage service quotas

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.

    For example:

    $ project_id=$(openstack project show -f value -c id PROJECT_NAME)
    
  2. List the default quotas for a project:

    $ cinder quota-defaults PROJECT_ID
    

    For example:

    $ cinder quota-defaults $project_id
    +-----------+-------+
    |  Property | Value |
    +-----------+-------+
    | gigabytes |  1000 |
    | snapshots |   10  |
    |  volumes  |   10  |
    +-----------+-------+
    
  3. View Block Storage service quotas for a project:

    $ cinder quota-show PROJECT_ID
    

    For example:

    $ cinder quota-show $project_id
    +-----------+-------+
    |  Property | Value |
    +-----------+-------+
    | gigabytes |  1000 |
    | snapshots |   10  |
    |  volumes  |   10  |
    +-----------+-------+
    
  4. Show the current usage of a per-project quota:

    $ cinder quota-usage PROJECT_ID
    

    For example:

    $ 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.

  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

    $ cinder quota-update --QUOTA_NAME QUOTA_VALUE PROJECT_ID
    

    Replace QUOTA_NAME with the quota that is to be updated, QUOTA_VALUE with the required new value, and PROJECT_ID with the required project ID.

    For example:

    $ cinder quota-update --volumes 15 $project_id
    $ cinder quota-show $project_id
    +-----------+-------+
    |  Property | Value |
    +-----------+-------+
    | gigabytes |  1000 |
    | snapshots |   10  |
    |  volumes  |   15  |
    +-----------+-------+
    
  3. To clear per-project quota limits:

    $ cinder quota-delete PROJECT_ID
    
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.