zun/api-ref/source/quotas.inc
Kien Nguyen d1d5dfe5fc Allow setting quota of other tenants
Currently, the quota API/CLI allows users to set
quotas for current tenant only. However, admin
users needs the ability to set quota for other
tenants. For example:

  $ source /opt/stack/devstack/openrc admin admin
  $ openstack appcontainer quota update --containers 100 <DEMO_TENANT_UUID>

Closes-Bug: #1807620
Change-Id: I9109d968d8010692644fd004a8085a43e1bdf60f
2018-12-24 14:25:56 +07:00

177 lines
2.7 KiB
ReStructuredText

.. -*- rst -*-
==============
Manage Quotas
==============
Gets, updates, gets default and deletes quotas for a project.
Update quotas for a project
===========================
.. rest_method:: PUT /v1/quotas/{project_id}
Update the quotas for a project
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
Request
-------
.. rest_parameters:: parameters.yaml
- project_id: project_id
- containers: container-request
- memory: memory-request
- cpu: cpu-request
- disk: disk-request
Request Example
---------------
.. literalinclude:: samples/quotas-update-req.json
:language: javascript
Response
--------
.. rest_parameters:: parameters.yaml
- containers: container-response
- memory: memory-response
- cpu: cpu-response
- disk: disk-response
Response Example
----------------
.. literalinclude:: samples/quotas-update-resp.json
:language: javascript
Get quotas for a project
========================
.. rest_method:: GET /v1/quotas/{project_id}
Get quotas for a project
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
Request
-------
.. rest_parameters:: parameters.yaml
- project_id: project_id
Response
--------
.. rest_parameters:: parameters.yaml
- usages: usages
- containers: container-response
- memory: memory-response
- cpu: cpu-response
- disk: disk-response
Response Example
----------------
.. literalinclude:: samples/quotas-get-resp.json
:language: javascript
Get Default quotas for a project
================================
.. rest_method:: GET /v1/quotas/{project_id}/defaults
Get the default quotas for a project
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
Request
-------
.. rest_parameters:: parameters.yaml
- project_id: project_id
Response
--------
.. rest_parameters:: parameters.yaml
- usages: usages
- containers: container-response
- memory: memory-response
- cpu: cpu-response
- disk: disk-response
Response Example
----------------
.. literalinclude:: samples/quotas-get-defaults-resp.json
:language: javascript
Revert Quotas to defaults
=========================
.. rest_method:: DELETE /v1/quotas/{project_id}
Reverts the quotas to default values for a project
.. rest_status_code:: success status.yaml
- 202
.. rest_status_code:: error status.yaml
- 401
- 403
Request
-------
.. rest_parameters:: parameters.yaml
- project_id: project_id
Response
--------
There is no body content for the response of a successful DELETE operation.