Examples in

Kontingente

Kontingente sind Limits pro Projekt, die begrenzen, wie viel einer Ressource ein Projekt haben kann. Sie verhindern ausufernde Kosten durch versehentliche Schleifen und stellen sicher, dass der Verbrauch eines Projekts nicht die Kapazität einer Region aufbraucht.

Wofür es Kontingente gibt

Jedes Projekt hat ein Kontingent für jede dieser Ressourcen:

Ressource	Standardkontingent	Hinweise
VMs	50	Pro Region; als „VM“ zählt jeder Zustand außer `terminated`
vCPU	200	Summe über alle laufenden VMs
RAM (GB)	800	Summe über alle laufenden VMs
Blockspeicher (GB)	5.000	Summe aller Volumes (angehängt + getrennt)
Objektspeicher (GB)	unbegrenzt	Nur weiches Limit: Ab ~50 TB melden wir uns bei Ihnen, um die Erwartungen abzustimmen
Snapshots	200	Pro Region; gelöschte Snapshots zählen nicht
Backups	500	Pro Region
Floating-IPs	20	Pro Region
Netzwerke	10	Pro Region
Sicherheitsgruppen	50	Pro Region
Load Balancer	10	Pro Region
DNS-Zonen	50	Projektweit
Benutzer	25	Projektweit

Die Standardwerte sind konservativ. Bei den meisten Produktionsprojekten werden die am stärksten genutzten Achsen (vCPU, RAM, Speicher) kurz nach dem Start auf 5–10× angehoben.

Kontingent vs. Verbrauch

Die Endpoints liefern beides:

GET /v1/quotas — die Limits (50 VMs, 200 vCPU usw.)
GET /v1/quotas/usage — den aktuellen Verbrauch (12 von 50 VMs genutzt, 48 von 200 vCPU usw.)

Prüfen Sie immer den Verbrauch, bevor Sie Ressourcen in großer Zahl erstellen; ein Request, der Sie über das Kontingent bringen würde, erhält 429 mit leerem Retry-After (da das Kontingent nicht zeitlich begrenzt ist, hilft Wiederholen nicht — Sie müssen etwas löschen oder das Kontingent erhöhen).

Kontingent erhöhen

Kontingenterhöhungen laufen über das Support-Kontaktformular, nicht über die API. Drei Gründe:

Kapazitätsplanung. Für große Erhöhungen (10×+) muss Hardware in der Zielregion reserviert werden.
Compliance. Manche Kontingenterhöhungen erfordern ein kurzes Gespräch über die Art des Workloads.
Missbrauchsschutz. Einen Self-Service-Endpoint für Kontingenterhöhungen würde ein kompromittiertes Konto als Erstes aufrufen.

Die meisten Erhöhungen sind in weniger als einem Werktag erledigt. Produktionsmigrationen werden noch am selben Tag bearbeitet, wenn Sie sie in der Anfrage kennzeichnen.

Kontingente über Regionen hinweg

Die meisten Kontingente gelten pro Region (VMs, Snapshots, Netzwerke). Einige gelten projektweit (DNS-Zonen, Benutzer). Die Antwort des Endpoints macht das explizit — jeder Kontingenteintrag hat ein Feld scope (region: us-east-1 oder project).

Nächste Schritte

Projekte — der Container, für den Kontingente gelten.
Authentifizierung — wie Sie diese Endpoints aufrufen.
Das Support-Kontaktformular unter /contact/support — dort beantragen Sie Kontingenterhöhungen.

Reference

GET/api/v1/quota-request/

Get Quota Request

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

Parameters

Name	In	Type	Description
id*	query	string	—

Responses

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

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/quota-request/?id=example" \
  -H "Authorization: Bearer $NIMBUS_KEY"

POST/api/v1/quota-request/

Create Quota Request

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

Request body

Field	Type	Description
reason	string \| null	—
service_name*	ServiceNameEnum	—
quota_name*	string	—
new_value*	integer	—
project_id	string \| null	—

Responses

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

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/quota-request/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_name": "nova",
    "quota_name": "example",
    "new_value": 1
  }'

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

Field	Type	Description
id*	string	—
new_value	integer \| null	—
state	QuotaRequestStateEnum \| null	—
admin_user_id	string \| null	—
message	string \| null	—

Responses

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

Example

curl -X PATCH "https://api.nimbusnexus.net/api/v1/quota-request/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "example"
  }'

DELETE/api/v1/quota-request/

Delete Quota Request

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

Parameters

Name	In	Type	Description
id*	query	string	—

Responses

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

Example

curl -X DELETE "https://api.nimbusnexus.net/api/v1/quota-request/?id=example" \
  -H "Authorization: Bearer $NIMBUS_KEY"

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

Field	Type	Description
id*	string	—

Responses

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

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/quota-request/approve" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "example"
  }'

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

Name	In	Type	Description
states	query	array of QuotaRequestStateEnum \| null	—
project_id	query	string \| null	—

Responses

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

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/quota-request/list" \
  -H "Authorization: Bearer $NIMBUS_KEY"

POST/api/v1/quota-request/reject

Admin Reject Quota Request

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

Request body

Field	Type	Description
id*	string	—
message	string	—

Responses

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

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/quota-request/reject" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "example"
  }'

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

Field	Type	Description
id*	string	—
message	string	—

Responses

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

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/quota-request/update" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "example"
  }'

GET/api/v1/quota/{service}

Get Quotas

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

Parameters

Name	In	Type	Description
service*	path	QuotaServiceEnum	—
admin_domain	query	string \| null	—
admin_project	query	string \| null	—
defaults	query	boolean \| null	—

Responses

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

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/quota/<service>" \
  -H "Authorization: Bearer $NIMBUS_KEY"

PATCH/api/v1/quota/{service}

Update Quotas

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

Parameters

Name	In	Type	Description
service*	path	QuotaServiceEnum	—

Request body

Field	Type	Description
admin_domain	string \| null	—
admin_project	string \| null	—
quotas*	object	—

Responses

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

Example

curl -X PATCH "https://api.nimbusnexus.net/api/v1/quota/<service>" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quotas": {}
  }'

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

Reset Quotas

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

Parameters

Name	In	Type	Description
service*	path	QuotaServiceEnum	—

Request body

Field	Type	Description
admin_domain	string \| null	—
admin_project	string \| null	—
quotas	array of string \| null	—

Responses

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

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/quota/<service>/reset" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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

Get Quota Usage

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

Parameters

Name	In	Type	Description
service*	path	QuotaServiceEnum	—
admin_domain	query	string \| null	—
admin_project	query	string \| null	—

Responses

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

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/quota/<service>/usage" \
  -H "Authorization: Bearer $NIMBUS_KEY"

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

Edit this page on GitHub