260 lines
7.5 KiB
ReStructuredText
260 lines
7.5 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:example_verification
|
|
.. needs:body_verification
|
|
|
|
============================
|
|
Quota sets (os-quota-sets)
|
|
============================
|
|
|
|
Permits administrators, depending on policy settings, to view default
|
|
quotas, view details for quotas, revert quotas to defaults, and update
|
|
the quotas for a project or a project and user.
|
|
|
|
Show A Quota
|
|
============
|
|
|
|
.. rest_method:: GET /v2.1/{admin_tenant_id}/os-quota-sets/{tenant_id}
|
|
|
|
Show the quota for a project or a project and a user.
|
|
|
|
In the request URI, you specify both the ID of the administrative project and the ID of the project for which you want to show quota.
|
|
|
|
To show a quota for a project and a user, specify the ``user_id`` query parameter.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- admin_tenant_id: admin_tenant_id
|
|
- tenant_id: tenant_id
|
|
- user_id: user_id_query_quota
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- quota_set: quota_set
|
|
- cores: cores
|
|
- fixed_ips: fixed_ips_quota
|
|
- floating_ips: floating_ips
|
|
- id: quota_tenant_or_user_id_body
|
|
- injected_file_content_bytes: injected_file_content_bytes
|
|
- injected_file_path_bytes: injected_file_path_bytes
|
|
- injected_files: injected_files
|
|
- instances: instances
|
|
- key_pairs: key_pairs
|
|
- metadata_items: metadata_items
|
|
- ram: ram
|
|
- security_group_rules: security_group_rules_quota
|
|
- security_groups: security_groups_quota
|
|
- server_groups: server_groups
|
|
- server_group_members: server_group_members
|
|
|
|
**Example Show A Quota: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-quota-sets/user-quotas-show-get-resp.json
|
|
:language: javascript
|
|
|
|
Update Quotas
|
|
=============
|
|
|
|
.. rest_method:: PUT /v2.1/{admin_tenant_id}/os-quota-sets/{tenant_id}
|
|
|
|
Update the quotas for a project or a project and a user.
|
|
|
|
You can force the update even if the quota has already been used and the reserved quota exceeds the new quota.
|
|
|
|
To force the update, specify the ``"force": "True"`` attribute in the request body. Default is ``false``. The following example request shows the optional ``force`` attribute.
|
|
|
|
To update a quota for a project and a user, specify the ``user_id`` query parameter.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- admin_tenant_id: admin_tenant_id
|
|
- tenant_id: tenant_id
|
|
- user_id: user_id_query_set_quota
|
|
- quota_set: quota_set
|
|
- force: force
|
|
- cores: cores_quota_optional
|
|
- fixed_ips: fixed_ips_quota_optional
|
|
- floating_ips: floating_ips_quota_optional
|
|
- injected_file_content_bytes: injected_file_content_bytes_quota_optional
|
|
- injected_file_path_bytes: injected_file_path_bytes_quota_optional
|
|
- injected_files: injected_files_quota_optional
|
|
- instances: instances_quota_optional
|
|
- key_pairs: key_pairs_quota_optional
|
|
- metadata_items: metadata_items_quota_optional
|
|
- ram: ram_quota_optional
|
|
- security_group_rules: security_group_rules
|
|
- security_groups: security_groups_quota_optional
|
|
- server_groups: server_groups_quota_optional
|
|
- server_group_members: server_group_members_quota_optional
|
|
|
|
**Example Update Quotas: JSON request**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-quota-sets/quotas-update-post-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- quota_set: quota_set
|
|
- cores: cores
|
|
- fixed_ips: fixed_ips_quota
|
|
- floating_ips: floating_ips
|
|
- injected_file_content_bytes: injected_file_content_bytes
|
|
- injected_file_path_bytes: injected_file_path_bytes
|
|
- injected_files: injected_files
|
|
- instances: instances
|
|
- key_pairs: key_pairs
|
|
- metadata_items: metadata_items
|
|
- ram: ram
|
|
- security_group_rules: security_group_rules_quota
|
|
- security_groups: security_groups_quota
|
|
- server_groups: server_groups
|
|
- server_group_members: server_group_members
|
|
|
|
**Example Update Quotas: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-quota-sets/quotas-update-post-resp.json
|
|
:language: javascript
|
|
|
|
Revert Quotas To Defaults
|
|
=========================
|
|
|
|
.. rest_method:: DELETE /v2.1/{admin_tenant_id}/os-quota-sets/{tenant_id}
|
|
|
|
Reverts the quotas to default values for a project or a project and a user.
|
|
|
|
To revert quotas for a project and a user, specify the ``user_id`` query parameter.
|
|
|
|
Normal response codes: 202
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- admin_tenant_id: admin_tenant_id
|
|
- tenant_id: tenant_id
|
|
- user_id: user_id_query_quota_delete
|
|
|
|
Response
|
|
--------
|
|
|
|
List Default Quotas For Tenant
|
|
==============================
|
|
|
|
.. rest_method:: GET /v2.1/{admin_tenant_id}/os-quota-sets/{tenant_id}/defaults
|
|
|
|
Lists the default quotas for a project.
|
|
|
|
In the request URI, you specify both the ID of the administrative project and the ID of the project for which you want to show default quotas. These project IDs can match.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- admin_tenant_id: admin_tenant_id
|
|
- tenant_id: tenant_id
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- quota_set: quota_set
|
|
- cores: cores
|
|
- fixed_ips: fixed_ips_quota
|
|
- floating_ips: floating_ips
|
|
- id: quota_tenant_or_user_id_body
|
|
- injected_file_content_bytes: injected_file_content_bytes
|
|
- injected_file_path_bytes: injected_file_path_bytes
|
|
- injected_files: injected_files
|
|
- instances: instances
|
|
- key_pairs: key_pairs
|
|
- metadata_items: metadata_items
|
|
- ram: ram
|
|
- security_group_rules: security_group_rules_quota
|
|
- security_groups: security_groups_quota
|
|
- server_groups: server_groups
|
|
- server_group_members: server_group_members
|
|
|
|
**Example List Default Quotas For Tenant: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-quota-sets/quotas-show-defaults-get-resp.json
|
|
:language: javascript
|
|
|
|
Show The Detail of Quota
|
|
========================
|
|
|
|
.. rest_method:: GET /v2.1/{admin_tenant_id}/os-quota-sets/{tenant_id}/detail
|
|
|
|
Show the detail of quota for a project or a project and a user.
|
|
|
|
In the request URI, you specify both the ID of the administrative project and the ID of the project for which you want to show the detail of quota.
|
|
|
|
To show a quota for a project and a user, specify the ``user_id`` query parameter.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- admin_tenant_id: admin_tenant_id
|
|
- tenant_id: tenant_id
|
|
- user_id: user_id_query_quota
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- quota_set: quota_set
|
|
- cores: cores_quota_details
|
|
- fixed_ips: fixed_ips_quota_details
|
|
- floating_ips: floating_ips_quota_details
|
|
- id: quota_tenant_or_user_id_body
|
|
- injected_file_content_bytes: injected_file_content_bytes_quota_details
|
|
- injected_file_path_bytes: injected_file_path_bytes_quota_details
|
|
- injected_files: injected_files_quota_details
|
|
- instances: instances_quota_details
|
|
- key_pairs: key_pairs_quota_details
|
|
- metadata_items: metadata_items_quota_details
|
|
- ram: ram_quota_details
|
|
- security_group_rules: security_group_rules_quota_details
|
|
- security_groups: security_groups_quota_details
|
|
- server_groups: server_groups_quota_details
|
|
- server_group_members: server_group_members_quota_details
|
|
|
|
**Example Show A Quota: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-quota-sets/quotas-show-detail-get-resp.json
|
|
:language: javascript
|