Skip to content
NimbusNexus

Quotas

Quotas are per-project limits that bound how much of any one resource a project can hold. They prevent runaway spend from accidental loops, and they make sure one project's usage can't drain a region's capacity.

What's quotaed

Every project has a quota on each of:

ResourceDefault quotaNotes
VMs50Per region; "VM" counts every state except terminated
vCPU200Total across every running VM
RAM (GB)800Total across every running VM
Block storage (GB)5,000Sum of every volume (attached + detached)
Object storage (GB)unlimitedSoft-only: we'll contact you above ~50 TB to align expectations
Snapshots200Per region; deleted snapshots don't count
Backups500Per region
Floating IPs20Per region
Networks10Per region
Security groups50Per region
Load balancers10Per region
DNS zones50Project-wide
Users25Project-wide

Defaults are conservative. Most production projects get bumped to 5–10× on the most-used axes (vCPU, RAM, storage) shortly after launch.

Quota vs usage

The endpoints expose both:

  • GET /v1/quotas — the limits (50 VMs, 200 vCPU, etc.)
  • GET /v1/quotas/usage — the current consumption (12 VMs used of 50, 48 vCPU of 200, etc.)

Always check usage before bulk-creating; a request that would push you past quota returns 429 with Retry-After blank (since the quota isn't time-bounded, retrying doesn't help — you need to delete something or raise the quota).

Raising a quota

Quota raises go through the support contact form, not the API. Three reasons:

  1. Capacity planning. Large raises (10×+) need to reserve hardware in the target region.
  2. Compliance. Some quota raises require a brief conversation about the workload shape.
  3. Abuse prevention. A self-service quota-raise endpoint would be the first thing a compromised account would call.

Most raises clear in under a business day. Production migrations get same-day turnaround if you flag them in the request.

Quota across regions

Most quotas are per-region (VMs, snapshots, networks). A few are project-wide (DNS zones, users). The endpoint response makes this explicit — each quota entry carries a scope field (region: us-east-1 or project).

What's next

Reference

GET/api/v1/quota-request/

Get Quota Request

Retrieve a single quota change request by ID within the caller's project.

Parameters

NameInRequiredDescription
idqueryyes—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/

POST/api/v1/quota-request/

Create Quota Request

Submit a new quota change request for the caller's project or domain.

Request body

JSON body required.

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/

PATCH/api/v1/quota-request/

Update Quota Request

Update an existing quota change request; non-admin callers may only edit their own request payload.

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/

DELETE/api/v1/quota-request/

Delete Quota Request

Delete a quota change request owned by the caller's project.

Parameters

NameInRequiredDescription
idqueryyes—

Responses

  • 204Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/

POST/api/v1/quota-request/approve

Admin Approve Quota Request

Admin endpoint that approves a pending quota change request and applies the new limits.

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/approve

GET/api/v1/quota-request/list

Get Quota Request List

List quota change requests for the caller's project, optionally filtered by request state.

Parameters

NameInRequiredDescription
statesqueryno—
project_idqueryno—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/list

POST/api/v1/quota-request/reject

Admin Reject Quota Request

Admin endpoint that rejects a quota change request with an explanatory message.

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/reject

POST/api/v1/quota-request/update

Admin Mark Quota Request For Update

Admin endpoint that flags a quota change request as needing further updates from the requester.

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota-request/update

GET/api/v1/quota/{service}

Get Quotas

Return current quota limits (or defaults) for the given service in the caller's scope.

Parameters

NameInRequiredDescription
servicepathyes—
admin_domainqueryno—
admin_projectqueryno—
defaultsqueryno—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota/{service}

PATCH/api/v1/quota/{service}

Update Quotas

Update quota limits for the given service in the caller's scope (admin only).

Parameters

NameInRequiredDescription
servicepathyes—

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota/{service}

POST/api/v1/quota/{service}/reset

Reset Quotas

Reset quota limits for the given service back to their default values (admin only).

Parameters

NameInRequiredDescription
servicepathyes—

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota/{service}/reset

GET/api/v1/quota/{service}/usage

Get Quota Usage

Return current resource usage for the given service in the caller's scope.

Parameters

NameInRequiredDescription
servicepathyes—
admin_domainqueryno—
admin_projectqueryno—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/quota/{service}/usage

Need to make a real call? Try these endpoints in the live Swagger UI →