Quota

View as Markdown

Fields

adjustablebooleanrequired
capacityinteger | nullrequired
rate quotas: the bucket's capacity for value (what usage.used is out of), else null.

minimum: 0
defaultintegerrequired
The default for the organization's tier.

minimum: 0
descriptionstringrequired
displayNamestringrequired
idstringrequired
. or ...

maxLength: 96, pattern: ^[a-z]{2,32}\.[a-z][A-Za-z0-9]{2,63}(\.[a-z][A-Za-z0-9]{1,63})?$
kindallocationorrateorusageorconcurrencyrequired
perRegionbooleanrequired
regionstringrequired
A region (us-west-1), or "" for what isn't regional.

pattern: ^([a-z]{2}-[a-z]+-[0-9]+)?$
resourceTypestring | nullrequired
scopeorganizationorprojectorresourcerequired
servicestringrequired
The owning product's namespace.
serviceNamestring | nullrequired
The owning product's name, from its registration (Widgets), or null.
sourceoverrideororganizationOverrideortierordefaultrequired
Which value applied: an override for the scope key, one for the whole organization, the tier's default, or the quota's default.
tierstring | nullrequired
The organization's tier when source is tier, else null.
unitstringrequired
usagenullorUsagerequired
null for narrower scopes without ?scopeKey= (see usageSummary and the quota's scopes), and for a perRegion quota without ?region=.
2 variants
One of the following:
null
Usage
View Usage schema →
4 properties
periodStartnullorInstantrequired
usage quotas only.

2 variants
One of the following:
null
Instant
resetsAtnullorInstantrequired
usage quotas only.

2 variants
One of the following:
null
Instant
stateavailableorunavailablerequired
unavailable: the product (allocation) or Quotas' Redis didn't answer in time; never a stale number.

usedinteger | nullrequired
allocation: in use; usage: this billing period; concurrency: in flight; rate: tokens in use of the bucket's capacity (capacity minus whole tokens available), never above capacity. null when unavailable.

minimum: 0
usageSummarynullorUsageSummaryrequired
When usage is null: where the scope keys (and regions) stand. Else null.
2 variants
One of the following:
null
UsageSummary
View UsageSummary schema →
7 properties
maxLimitinteger | nullrequired
…its limit.

minimum: 0
maxRegionnullorRegionrequired
…its region.

2 variants
One of the following:
null
Region
maxScopeKeynullorUuidrequired
…its scope key.

2 variants
One of the following:
null
Uuid
maxUsedinteger | nullrequired
The row using the largest share of its limit: its usage.

minimum: 0
scopeKeysintegerrequired
Rows (scope key and region) with known usage.

minimum: 0
scopeKeysNearintegerrequired
Rows at 80% of their limit (the value; a rate quota's capacity) or more.

minimum: 0
stateavailableorunavailablerequired
unavailable: some usage couldn't be read; the counts are of what could be.
valueintegerrequired
The value that applies: the organization's, a scope key without its own override's, or with ?scopeKey= that scope key's.

minimum: 0
windowstring | nullrequired
rate quotas: PT1S to PT1H.
scopesarray ofobjectrequired
Every scope key with an override or known usage, or only ?scopeKey=; for a perRegion quota, a row per region (or only ?region=). An organization-scoped quota's scope key is the organization.
7 properties
- capacityinteger | nullrequired
  minimum: 0
- regionstringrequired
  A region (us-west-1), or "" for what isn't regional.
  
  pattern: ^([a-z]{2}-[a-z]+-[0-9]+)?$
- scopeKeystringrequired
  A lowercase UUID.
  
  pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
- sourceoverrideororganizationOverrideortierordefaultrequired
  Which value applied: an override for the scope key, one for the whole organization, the tier's default, or the quota's default.
- tierstring | nullrequired
- usageobjectrequired
  4 properties
  periodStartnullorInstantrequired
  usage quotas only.
  
  2 variants
  One of the following:
  null
  Instant
  resetsAtnullorInstantrequired
  usage quotas only.
  
  2 variants
  One of the following:
  null
  Instant
  stateavailableorunavailablerequired
  unavailable: the product (allocation) or Quotas' Redis didn't answer in time; never a stale number.
  
  usedinteger | nullrequired
  allocation: in use; usage: this billing period; concurrency: in flight; rate: tokens in use of the bucket's capacity (capacity minus whole tokens available), never above capacity. null when unavailable.
  
  minimum: 0
- valueintegerrequired
  minimum: 0
usageAvailablebooleanrequired
false when some usage couldn't be read: rows known only from the product's usage are then missing, and rows shown have usage unavailable.