> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-docs-api-reference-demo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quota

> Resource allowances, claims, and grants that govern usage on Datum Cloud — the quota.miloapis.com API.

Datum Cloud governs how much of each resource type a consumer may use through the `quota.miloapis.com` API. Capacity is allocated to a consumer with a **ResourceGrant**, individual requests draw against that capacity with a **ResourceClaim**, and an **AllowanceBucket** continuously aggregates the two to report how much remains available for admission decisions.

<Warning>
  The quota API is **alpha** (`v1alpha1`). Fields and behavior may change in backward-incompatible ways between releases.
</Warning>

## Resources

<CardGroup cols={2}>
  <Card title="AllowanceBucket" icon="gauge" href="/api/quota/allowancebucket">
    Aggregates quota limits and usage for a single consumer and resource type, reporting the capacity still available.
  </Card>

  <Card title="ResourceClaim" icon="hand" href="/api/quota/resourceclaim">
    Requests quota allocation when a resource is created, consuming capacity from the matching bucket.
  </Card>

  <Card title="ResourceGrant" icon="ticket" href="/api/quota/resourcegrant">
    Allocates quota capacity to a consumer for specific resource types, supplying the allowances buckets aggregate.
  </Card>
</CardGroup>

## How the pieces fit together

* A **ResourceGrant** grants a consumer capacity for one or more resource types. Only grants with an `Active` status contribute to available quota.
* An **AllowanceBucket** is created automatically for each unique consumer and resource type. It sums capacity from active grants and consumption from granted claims, then reports the remaining `status.available`.
* A **ResourceClaim** requests an allocation for a resource type. The quota system checks the matching bucket's available capacity to decide whether the claim can be granted.

<Tip>
  Inspect the exact fields for any resource with `datumctl explain`, for example `datumctl explain allowancebuckets.spec` or `datumctl explain resourceclaims.spec`.
</Tip>

## Learn more

* [API resources overview](/api/overview) — the resource reference landing page across all Datum Cloud services.
* [Changing resources](/datumctl/resources/changing) — how to apply, edit, and safely preview changes to these resources.