Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Terminology clarification between Limit, Quota and Service Limit #126

Open
darrelmiller opened this issue Jan 22, 2023 · 3 comments
Open

Comments

@darrelmiller
Copy link
Contributor

I'm not sure if there are subtle distinctions between these three terms, but in places they seem to mean the same thing.

RateLimit-Limit: the server's quota seems to infer that limit is the quota.

The service limit is a non-negative Integer indicating the maximum amount of activity that the server is willing to accept In the quota policy, the term service limit seems to be referring to the same thing.

Considering that Quota Policy is defined as an SF Item, it seems like it might be redundant to also define a Service Limit as a distinct thing.

In summary, I think we might be able to bring more clarity by reducing the number of terms that are being used to describe what appear to me to be the same thing. However, I may be missing something.

@guzi99
Copy link

guzi99 commented Jan 27, 2023

I think quota and rate limits are interchangeable.

@ioggstream
Copy link
Collaborator

ioggstream commented Jan 30, 2023

We probably need to tune up the language in Introduction, that contains the sentence below.

RateLimit-Limit: the server's quota

The term "quota" does not exist alone in the spec. You either have "quota units" or "quota policy". The "quota policy" is made of a "service limit" and a "time window".

Defining "service limit" is useful wrt the concept of "expiring limit" when there are multiple quota policies at stake, or when the server advertises an expiring limit lower than the one specified in the quota policies (e.g. due to saturation).

@abatishchev
Copy link

I think quota and rate limits are interchangeable

Let me disagree. In my service (which is the throttling space in Azure) we distinguish these two:

  • rate limiting (aka traffic shaping, if you will) when the time window is measured in seconds or minutes) as the immediate protection of the server resources
  • quota management (when the time window is measured in hours, often even in days, sometimes in weeks) for scenarios like billing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: In Discussion
Development

No branches or pull requests

4 participants