A quota is similar to a rate limit, as it allows a certain number of requests through in a time period. However traditionally these periods are much longer, For example, if you would like to have a user only have 10,000 requests to the API per month, you can create a key that has no rate limiting but will disallow access once the quota is empty. Tyk will automatically reset the quota if the time limit on reset has been exceeded.
How do quotas work?
Quotas in Tyk use a decrementing counter in the token’s session object to measure when to block inbound requests.
How do quotas renew?
In Tyk, most things are event-driven, the same goes for quotas, since all quotas have a reset time limit, they do not “reset” on a specific date (e.g. 1st of the month), instead they “reset” on or after a date has passed, and only when the key is actively being used. This means that the period can “move” if the token is only partially active.
Why is the quota system like this?
In a system with 1,000,000 tokens, managing timers to watch and monitor each token is extremely expensive and inefficient. So in order to keep quotas sane and not clutter up the DB with unnecessary timers, quotas are event-driven.
It is possible to have monthly quotas that set on a specific date, using the Tyk Gateway API it is possible to reset known token quotas periodically using an external timer.
Can I disable quotas?
Yes you can - to disable the quota middleware in an API definition, select the Disable Quotas option in your API designer, or set the value of
true in your API Definition.
Visit the key creation screen by browsing to “System Management” -> “Keys” -> “Add Key”.
Ensure the new key has access to the APIs you wish it work with by selecting the API from the “Access Rights” -> “Add Access Rule” and clicking the “add” button.
Under the “Usage Quotas” section of the page, “Max Quota” - this is the maximum number of requests that are allowed to pass through the proxy during the period.
Set the “Quota resets every” drop down to the period you would like the quota to be active for. If the pre-sets do not meet your requirements, the quota period can be set using the session object method and the REST API.
- Save the token, it will be created instantly.
In order to set a quota for a token:
- Ensure that
quota_maxis set to the maximum amount of requests that a user is allowed to make in a time period.
quota_remainingis set to the same value as
quota_max, this is the value that will decrement on each request (failed or successful).
- Set the
quota_renewal_rateto the value, in seconds, of when the quota should renew. For example, if you would like it to renew every 30 days, you would have
(((60*60) * 24) * 30 = 2592000).
Note: To set an unlimited quota, set