Quota

A quota is a limit on how much of one resource your org may use: a pair of numbers, current for what the org uses right now and max for the most it is allowed to reach. When current reaches max, creating more of that resource is rejected until usage drops or the max is raised.

​

How It Fits

A quota increase request moves through one of three statuses.

​

Key Behaviors

• A request asks for one quota’s new max. You submit the exact quota name, taken from your org’s quota list or the catalog, and the max you want. Requests within the range Control Plane grants automatically are approved immediately; larger ones wait as pending for review by the Control Plane team.
• You can track a request after submitting it. Retrieve it by its ID or list your org’s requests, optionally filtered by status; each request records the requested max, who submitted it, and who resolved it.
• Control Plane notifies you of the outcome. The answer goes to whoever submitted the request, and an approved max appears on the quota the next time you view your quotas.
• Deleting a resource frees its quota room at once. current drops in the same operation that deletes the resource, so clearing out what the org no longer needs is the immediate alternative to raising a max.
• A quota near its limit is visible in metrics. Once a quota passes half its max, your org’s built-in metrics report it as quota_utilization_percent, so you can chart and alert on a quota before creations start failing.

​

Gotchas

• The rejection names the quota. Creating a resource whose quota is full fails with Quota <workloads-per-gvc> has been maxed out (max=20). You can request quota increase from Control Plane administrators., so the error itself tells you which quota to raise.
• An increase request never lowers a quota. A request for a value at or below the current max is treated as already satisfied and changes nothing. To lower a max, contact support@controlplane.com.
• A quota cannot be edited directly. It is a built-in object that Control Plane maintains, and an edit is refused whatever your permissions; raising a max goes through an increase request.
• The catalog carries no numbers for your org. A catalog entry describes a quota in general, its default max included; the live current and max are on your org’s own quota list.
• The cap on orgs themselves lives outside the org. How many orgs you may create is a billing account limit raised through support, separate from the quotas an org holds.

​

Learn More