Skip to main content

​
Overview

A quota is a limit on how many of a given Control Plane resource your org may use. Each quota tracks two values:
  • Current — how much of the resource the org is using right now.
  • Max — the highest value the org is allowed to reach.
When the current usage of a resource reaches its max, further attempts to create that resource are rejected until usage drops or the max is raised. Quotas are applied per org. Some are counted at the org level (for example, the number of domains), while others are counted within each GVC (for example, the number of workloads per GVC). See the Quota reference for the full list of resources that have a quota.

​
Quota Catalog

The quota catalog is the read-only list of every quota that can exist on an org. Each catalog entry describes a quota by name, along with the unit it is measured in and a short description. Use the catalog to discover which quotas you can view and request increases for, and the exact quotaName to use when submitting a request. A catalog entry is not org-specific — it describes the quota in general. To see the current and max values for a quota on your own org, list your org’s quotas instead.

​
Increasing a Quota

When you need a higher limit, submit a quota increase request for a single quota and the new max you want. Control Plane then evaluates the request:
  • Requests that fall within the range Control Plane can grant automatically are approved immediately, and the higher limit is applied to your org shortly afterward.
  • Larger requests are placed in the pending state and reviewed by the Control Plane team before being approved or denied.
A quota increase request moves through one of the following statuses: Each request records the new max you asked for (requestedMax), who submitted it, when it was created, and—once it is no longer pending—when and by whom it was resolved. Approved requests, whether automatic or reviewed, raise the quota’s max only when the current max is below the requested value; a request for a value at or below the current max is considered already satisfied. You can track a request after submitting it by retrieving it by its ID, or by listing all of your org’s requests (optionally filtered by status). See Check the status of a request in the guide.
Requesting an increase never lowers a quota. To request a value below your current max, contact support@controlplane.com.

​
Permissions

Viewing quotas and submitting quota increase requests for an org require the org-level view permission. See Quota permissions for the permissions used to define policies.

​
Next Steps

  • Follow the Manage Quotas guide to view quotas, browse the catalog, and submit and track increase requests through the API.
  • See the Quota reference for the list of quota resources and their permissions.