api-site/api-ref/source/share/v1/share-limits.inc
Anne Gentle ac4cc65cb5 Adds migrated RST + YAML files from WADL
Contains .inc files which have all the contents of the .rst files
but are grouped together for easier editing.
Contains parameters.yaml, which has all parameters in one file.
Contains request and response samples (JSON and XML) that are
pointed to from the .inc files.

Change-Id: I42d5451300f95774a3ec4df66bc95cb36795844d
2016-05-02 17:42:49 -05:00

86 lines
1.9 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/{tenant_id}/limits
Lists share limits.
Normal response codes: 200
Error response codes:
Request
-------
.. rest_parameters:: parameters.yaml
- tenant_id: tenant_id
Response Parameters
-------------------
.. rest_parameters:: parameters.yaml
- regex: regex
- verb: verb
- totalShareNetworksUsed: totalShareNetworksUsed
- maxTotalShareGigabytes: maxTotalShareGigabytes
- maxTotalShareNetworks: maxTotalShareNetworks
- totalSharesUsed: totalSharesUsed
- uri: uri
- value: value
- totalShareGigabytesUsed: totalShareGigabytesUsed
- totalShareSnapshotsUsed: totalShareSnapshotsUsed
- next-available: next-available
- unit: unit
- maxTotalShares: maxTotalShares
- totalSnapshotGigabytesUsed: totalSnapshotGigabytesUsed
- maxTotalSnapshotGigabytes: maxTotalSnapshotGigabytes
- remaining: remaining
- maxTotalShareSnapshots: maxTotalShareSnapshots
Response Example
----------------
.. literalinclude:: ../samples/manila-limits-response.json
:language: javascript