d7140ffe09
Nowadays "project" and "project_id" are used instead of "tenant" in the OpenStack world. See [1] and [2]. - Replace "tenant_id" in the API paths to "project_id" - For most manila resources, the "project_id" in an API response body refers to the project that owns the resource. So, create a unified parameter and share that across the APIs. - Fix path variable names, and their order - Fix usage of "UUID" to refer to project and user IDs - Fix query parameters [1] https://docs.openstack.org/operations-guide/ops-projects-users.html [2] https://developer.openstack.org/api-ref/identity/v3/index.html#projects Partial-Bug: #1760644 Co-Authored-By: Goutham Pacha Ravi <gouthampravi@gmail.com> Change-Id: I64e4ef8ad258d07c7d80d11a4d015c4b82156722
88 lines
2.0 KiB
ReStructuredText
88 lines
2.0 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
======
|
|
Limits
|
|
======
|
|
|
|
Limits are the resource limitations that are allowed for each
|
|
tenant (project). An administrator can configure limits in the
|
|
``manila.conf`` file.
|
|
|
|
Users can query their rate and absolute limits. The absolute limits
|
|
contain information about:
|
|
|
|
- Total maximum share memory, in GBs.
|
|
|
|
- Number of share-networks.
|
|
|
|
- Number of share-snapshots.
|
|
|
|
- Number of shares.
|
|
|
|
- Shares and total used memory, in GBs.
|
|
|
|
- Snapshots and total used memory, in GBs.
|
|
|
|
Rate limits control the frequency at which users can issue specific
|
|
API requests. Administrators use rate limiting to configure limits
|
|
on the type and number of API calls that can be made in a specific
|
|
time interval. For example, a rate limit can control the number of
|
|
GET requests that can be processed during a one-minute period.
|
|
|
|
|
|
List share limits
|
|
=================
|
|
|
|
.. rest_method:: GET /v2/{project_id}/limits
|
|
|
|
Lists share limits.
|
|
|
|
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_path
|
|
|
|
Response parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- maxTotalShareGigabytes: maxTotalShareGigabytes
|
|
- maxTotalSnapshotGigabytes: maxTotalSnapshotGigabytes
|
|
- maxTotalShares: maxTotalShares
|
|
- maxTotalShareSnapshots: maxTotalShareSnapshots
|
|
- maxTotalShareNetworks: maxTotalShareNetworks
|
|
- totalSharesUsed: totalSharesUsed
|
|
- totalShareSnapshotsUsed: totalShareSnapshotsUsed
|
|
- totalShareNetworksUsed: totalShareNetworksUsed
|
|
- totalShareGigabytesUsed: totalShareGigabytesUsed
|
|
- totalSnapshotGigabytesUsed: totalSnapshotGigabytesUsed
|
|
- uri: uri
|
|
- regex: regex
|
|
- value: value
|
|
- verb: verb
|
|
- remaining: remaining
|
|
- unit: unit
|
|
- next-available: next-available
|
|
|
|
Response example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/limits-response.json
|
|
:language: javascript
|