Quotas

The configurable limits on packages and bytes per application and organization, how logical use is counted, and what happens when a limit is reached.

  • Availability: Planned
  • Evidence: Read from source
  • Reference

Operation

Operation Request Capability
quotas.read GET /v1/organizations/{organization}/quotas usage.read

The answer lists each quota with its unit (count, bytes or credits), its limit, its used amount and, for application quotas, the application.

Quotas

Name Limits
application.packages Pinned packages in one application graph
package.compressed Size of one package archive, enforced before and during download
package.extracted Extracted size of one package, enforced while extracting
package.entries Number of entries in one archive, enforced while extracting
application.bytes Logical bytes attributed to one application across its retained releases
organization.bytes Logical bytes attributed to one organization
organization.applications The number of applications of the organization
physical.bytes The capacity of the shared physical store the operator provisions. A platform quota.
budget The platform's global admission budget for the accounting period, in credits. A platform quota.

For the two platform quotas, used is what the service chooses to disclose to the organization, which may be 0.

Logical and physical use

used is logical use. The CDN stores a public package once however many applications depend on it, and that physical saving never lowers anyone's logical use. Shared physical capacity is a separate limit that the operator provisions; when it is exhausted, admission stops accepting inputs that are not already stored.

When a limit is reached

  • At admission, a request that would pass a quota is refused with 409 QUOTA_EXCEEDED; details.quota names the quota. Creating an application beyond organization.applications is refused the same way. When the global budget does not admit new work the answer is 503 BUDGET_EXHAUSTED.
  • Limits on archives are enforced while downloading and extracting, which is what stops an archive that expands far beyond its compressed size. The job then fails with QUOTA_EXCEEDED.
  • Work that cannot fit a time budget ends with LIMIT_EXCEEDED. See Jobs.

None of these outcomes changes the active release.