openstack/openstack-manuals
Code Issues Proposed changes
6c67b2be17
openstack-manuals/doc/user-guide-admin/source/cli_set_compute_quotas.rst
Brant Knudson 147068841a Use openstack rather than keystone 
The keystone command is deprecated and should be not used in the
examples. The openstack command is the replacement.

The openstack command has handy options for extracting fields
so some of the commands were simplified.

The openstack command can use names when creating role
assignments and since this is more user-friendly the examples
were changed to use names rather than IDs.

Change-Id: Ic118284183001d10322cf357314672c5d98856a3
2015-07-12 13:51:36 +00:00

8.6 KiB
Raw Blame History

Manage Compute service quotas

As an administrative user, you can use the nova quota-* commands, which are provided by the python-novaclient package, to update the Compute service quotas for a specific tenant or tenant user, as well as update the quota defaults for a new tenant.

Compute quota descriptions

Quota name Description
cores Number of instance cores (VCPUs) allowed per tenant.
fixed-ips Number of fixed IP addresses allowed per tenant. This number must be equal to or greater than the number of allowed instances.
floating-ips Number of floating IP addresses allowed per tenant.
injected-file-content-bytes Number of content bytes allowed per injected file.
injected-file-path-bytes Length of injected file path.
injected-files Number of injected files allowed per tenant.
instances Number of instances allowed per tenant.
key-pairs Number of key pairs allowed per user.
metadata-items Number of metadata items allowed per instance.
ram Megabytes of instance ram allowed per tenant.
security-groups Number of security groups per tenant.
security-group-rules Number of rules per security group.

View and update Compute quotas for a tenant (project)

To view and update default quota values

  1. List all default quotas for all tenants, as follows:

    $ nova quota-defaults

    For example:

    $ nova quota-defaults
+-----------------------------+-------+
| Quota                       | Limit |
+-----------------------------+-------+
| instances                   | 10    |
| cores                       | 20    |
| ram                         | 51200 |
| floating_ips                | 10    |
| fixed_ips                   | -1    |
| metadata_items              | 128   |
| injected_files              | 5     |
| injected_file_content_bytes | 10240 |
| injected_file_path_bytes    | 255   |
| key_pairs                   | 100   |
| security_groups             | 10    |
| security_group_rules        | 20    |
+-----------------------------+-------+

  2. Update a default value for a new tenant, as follows:

    $ nova quota-class-update --KEY VALUE default

    For example:

    $ nova quota-class-update --instances 15 default

To view quota values for an existing tenant (project)

  1. Place the tenant ID in a usable variable, as follows:

    $ tenant=$(openstack project show -f value -c id TENANT_NAME)

  2. List the currently set quota values for a tenant, as follows:

    $ nova quota-show --tenant $tenant

    For example:

    $ nova quota-show --tenant $tenant
+-----------------------------+-------+
| Quota                       | Limit |
+-----------------------------+-------+
| instances                   | 10    |
| cores                       | 20    |
| ram                         | 51200 |
| floating_ips                | 10    |
| fixed_ips                   | -1    |
| metadata_items              | 128   |
| injected_files              | 5     |
| injected_file_content_bytes | 10240 |
| injected_file_path_bytes    | 255   |
| key_pairs                   | 100   |
| security_groups             | 10    |
| security_group_rules        | 20    |
+-----------------------------+-------+

To update quota values for an existing tenant (project)

  1. Obtain the tenant ID, as follows:

    $ tenant=$(openstack project show -f value -c id TENANT_NAME)

  2. Update a particular quota value, as follows:

    $ nova quota-update --QUOTA_NAME QUOTA_VALUE TENANT_ID

    For example:

    $ nova quota-update --floating-ips 20 $tenant
$ nova quota-show --tenant $tenant
+-----------------------------+-------+
| Quota                       | Limit |
+-----------------------------+-------+
| instances                   | 10    |
| cores                       | 20    |
| ram                         | 51200 |
| floating_ips                | 20    |
| fixed_ips                   | -1    |
| metadata_items              | 128   |
| injected_files              | 5     |
| injected_file_content_bytes | 10240 |
| injected_file_path_bytes    | 255   |
| key_pairs                   | 100   |
| security_groups             | 10    |
| security_group_rules        | 20    |
+-----------------------------+-------+

    Note

    To view a list of options for the quota-update command, run:

    $ nova help quota-update

View and update Compute quotas for a tenant user

To view quota values for a tenant user

  1. Place the user ID in a usable variable, as follows:

    $ tenantUser=$(openstack user show -f value -c id USER_NAME)

  2. Place the user's tenant ID in a usable variable, as follows:

    $ tenant=$(openstack project show -f value -c id TENANT_NAME)

  3. List the currently set quota values for a tenant user, as follows:

    $ nova quota-show --user $tenantUser --tenant $tenant

    For example:

    $ nova quota-show --user $tenantUser --tenant $tenant
+-----------------------------+-------+
| Quota                       | Limit |
+-----------------------------+-------+
| instances                   | 10    |
| cores                       | 20    |
| ram                         | 51200 |
| floating_ips                | 20    |
| fixed_ips                   | -1    |
| metadata_items              | 128   |
| injected_files              | 5     |
| injected_file_content_bytes | 10240 |
| injected_file_path_bytes    | 255   |
| key_pairs                   | 100   |
| security_groups             | 10    |
| security_group_rules        | 20    |
+-----------------------------+-------+

To update quota values for a tenant user

  1. Place the user ID in a usable variable, as follows:

    $ tenantUser=$(openstack user show -f value -c id USER_NAME)

  2. Place the user's tenant ID in a usable variable, as follows:

    $ tenant=$(openstack project show -f value -c id TENANT_NAME)

  3. Update a particular quota value, as follows:

    $ nova quota-update  --user $tenantUser --QUOTA_NAME QUOTA_VALUE $tenant

    For example:

    $ nova quota-update --user $tenantUser --floating-ips 12 $tenant
$ nova quota-show --user $tenantUser --tenant $tenant
+-----------------------------+-------+
| Quota                       | Limit |
+-----------------------------+-------+
| instances                   | 10    |
| cores                       | 20    |
| ram                         | 51200 |
| floating_ips                | 12    |
| fixed_ips                   | -1    |
| metadata_items              | 128   |
| injected_files              | 5     |
| injected_file_content_bytes | 10240 |
| injected_file_path_bytes    | 255   |
| key_pairs                   | 100   |
| security_groups             | 10    |
| security_group_rules        | 20    |
+-----------------------------+-------+

    Note

    To view a list of options for the quota-update command, run:

    $ nova help quota-update

To display the current quota usage for a tenant user

Use nova absolute-limits to get a list of the current quota values and the current quota usage:

$ nova absolute-limits --tenant TENANT_NAME
 +-------------------------+-------+
 | Name                    | Value |
 +-------------------------+-------+
 | maxServerMeta           | 128   |
 | maxPersonality          | 5     |
 | maxImageMeta            | 128   |
 | maxPersonalitySize      | 10240 |
 | maxTotalRAMSize         | 51200 |
 | maxSecurityGroupRules   | 20    |
 | maxTotalKeypairs        | 100   |
 | totalRAMUsed            | 0     |
 | maxSecurityGroups       | 10    |
 | totalFloatingIpsUsed    | 0     |
 | totalInstancesUsed      | 0     |
 | totalSecurityGroupsUsed | 0     |
 | maxTotalFloatingIps     | 10    |
 | maxTotalInstances       | 10    |
 | totalCoresUsed          | 0     |
 | maxTotalCores           | 20    |
 +-------------------------+-------+