318a6b606b
project_id and tenant_id field in request/response body are marked as "path" now. It should be "body". - "project_id-path" already exists and it can be used for "project_id" in URL path. - "project_id" is now used for body. - "project_id-body" is now duplicated, so it was removed. fwaas.inc is the only user of project_id-body and it is updated accordingly. - quotas.inc is updated to use 'project_id-path'. Also project_id and tenant_id in response body of a quotas operation have been dropped as they do not exist. Note that project_id/tenant_id in request body should be marked as "optional" in most resources but this patch does not touch them to avoid unnecessary merge conflicts. They will be fixed in separate patches. Change-Id: Ic5a4f55b837ee0a51b7186c3342a94c8c00f6c97 Closes-Bug: #1650174
203 lines
4.3 KiB
ReStructuredText
203 lines
4.3 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:method_verification
|
|
.. needs:parameter_verification
|
|
.. needs:example_verification
|
|
.. needs:body_verification
|
|
|
|
=========================
|
|
Quotas extension (quotas)
|
|
=========================
|
|
|
|
Lists default quotas, current quotas for projects with non-default quota
|
|
values, and shows, updates, and resets quotas for a project.
|
|
|
|
A quota value of ``-1`` means that quota has no limit.
|
|
|
|
List quotas for projects with non-default quota values
|
|
======================================================
|
|
|
|
.. rest_method:: GET /v2.0/quotas
|
|
|
|
Lists quotas for projects with non-default quota values.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 401, 403
|
|
|
|
Request
|
|
-------
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- subnet: quota-subnet
|
|
- network: quota-network
|
|
- floatingip: quota-floatingip
|
|
- subnetpool: quota-subnetpool
|
|
- quotas: quotas
|
|
- security_group_rule: quota-security_group_rule
|
|
- security_group: quota-security_group
|
|
- router: quota-router
|
|
- rbac_policy: quota-rbac_policy
|
|
- port: quota-port
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/quotas/quotas-list-response.json
|
|
:language: javascript
|
|
|
|
List quotas for a project
|
|
=========================
|
|
|
|
.. rest_method:: GET /v2.0/quotas/{project_id}
|
|
|
|
Lists quotas for a project.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 401, 403, 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id-path
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- subnet: quota-subnet
|
|
- network: quota-network
|
|
- floatingip: quota-floatingip
|
|
- subnetpool: quota-subnetpool
|
|
- quotas: quotas
|
|
- security_group_rule: quota-security_group_rule
|
|
- security_group: quota-security_group
|
|
- router: quota-router
|
|
- rbac_policy: quota-rbac_policy
|
|
- port: quota-port
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/quotas/quotas-list-for-project-response.json
|
|
:language: javascript
|
|
|
|
Update quota for a project
|
|
==========================
|
|
|
|
.. rest_method:: PUT /v2.0/quotas/{project_id}
|
|
|
|
Updates quotas for a project. Use when non-default quotas are desired.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 401, 403, 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id-path
|
|
- subnet: quota-subnet
|
|
- network: quota-network
|
|
- floatingip: quota-floatingip
|
|
- subnetpool: quota-subnetpool
|
|
- quotas: quotas
|
|
- security_group_rule: quota-security_group_rule
|
|
- security_group: quota-security_group
|
|
- router: quota-router
|
|
- rbac_policy: quota-rbac_policy
|
|
- port: quota-port
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/quotas/quotas-update-request.json
|
|
:language: javascript
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- subnet: quota-subnet
|
|
- network: quota-network
|
|
- floatingip: quota-floatingip
|
|
- subnetpool: quota-subnetpool
|
|
- quotas: quotas
|
|
- security_group_rule: quota-security_group_rule
|
|
- security_group: quota-security_group
|
|
- router: quota-router
|
|
- rbac_policy: quota-rbac_policy
|
|
- port: quota-port
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/quotas/quotas-update-response.json
|
|
:language: javascript
|
|
|
|
Reset quota for a project
|
|
=========================
|
|
|
|
.. rest_method:: DELETE /v2.0/quotas/{project_id}
|
|
|
|
Resets quotas to default values for a project.
|
|
|
|
Error response codes: 204, 401, 403, 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id-path
|
|
|
|
List default quotas for a project
|
|
=================================
|
|
|
|
.. rest_method:: GET /v2.0/quotas/{project_id}/default
|
|
|
|
Lists default quotas for a project.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 401, 403, 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id-path
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- quota: quota
|
|
- floatingip: quota-floatingip
|
|
- network: quota-network
|
|
- port: quota-port
|
|
- rbac_policy: quota-rbac_policy
|
|
- router: quota-router
|
|
- security_group: quota-security_group
|
|
- security_group_rule: quota-security_group_rule
|
|
- subnet: quota-subnet
|
|
- subnetpool: quota-subnetpool
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/quotas/quotas-list-for-project-response.json
|
|
:language: javascript
|