The operation allocates quota for the amount specified in the service
configuration or specified using the quota metrics. If the requested
amount is higher than the available quota, request does not fail and
remaining quota would become negative (going over the limit).
Not supported for Rate Quota.
BestEffort
The operation allocates quota for the amount specified in the service
configuration or specified using the quota metrics. If the amount is
higher than the available quota, request does not fail but all available
quota will be allocated.
For rate quota, BEST_EFFORT will continue to deduct from other groups
even if one does not have enough quota. For allocation, it will find the
minimum available amount across all groups and deduct that amount from
all the affected groups.
CheckOnly
For AllocateQuota request, only checks if there is enough quota
available and does not change the available quota. No lock is placed on
the available quota either.
Normal
For AllocateQuota request, allocates quota for the amount specified in
the service configuration or specified using the quota metrics. If the
amount is higher than the available quota, allocation error will be
returned and no quota will be allocated.
If multiple quotas are part of the request, and one fails, none of the
quotas are allocated or released.
QueryOnly
Unimplemented. When used in AllocateQuotaRequest, this returns the
effective quota limit(s) in the response, and no quota check will be
performed. Not supported for other requests, and even for
AllocateQuotaRequest, this is currently supported only for allowlisted
services.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe latest version of the \u003ccode\u003eQuotaOperation.Types.QuotaMode\u003c/code\u003e enum is 2.4.0, with older versions ranging down to 1.0.0 available for use.\u003c/p\u003e\n"],["\u003cp\u003eThis API enum provides different modes for managing quota operations within the Service Control v1 API, including \u003ccode\u003eAdjustOnly\u003c/code\u003e, \u003ccode\u003eBestEffort\u003c/code\u003e, \u003ccode\u003eCheckOnly\u003c/code\u003e, \u003ccode\u003eNormal\u003c/code\u003e, \u003ccode\u003eQueryOnly\u003c/code\u003e, and \u003ccode\u003eUnspecified\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eNormal\u003c/code\u003e quota mode will only allocate quota if the requested amount is available, while \u003ccode\u003eBestEffort\u003c/code\u003e will allocate the maximum available quota if the requested amount exceeds the current limits.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCheckOnly\u003c/code\u003e mode allows for verifying quota availability without actually changing the quota, whereas the \u003ccode\u003eAdjustOnly\u003c/code\u003e mode will allocate the requested quota, even if that puts it over the available amount.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eQueryOnly\u003c/code\u003e quota mode is to only return quota limits, and is currently supported only for allowlisted services, whilst the \u003ccode\u003eUnspecified\u003c/code\u003e quota mode should not be used.\u003c/p\u003e\n"]]],[],null,[]]
