Examples in

Cuotas

Las cuotas son límites por proyecto que acotan cuánto de cada recurso puede tener un proyecto. Evitan que el gasto se dispare por bucles accidentales y garantizan que el consumo de un proyecto no pueda agotar la capacidad de una región.

Qué tiene cuota

Cada proyecto tiene una cuota para cada uno de estos recursos:

Recurso	Cuota por defecto	Notas
VMs	50	Por región; "VM" cuenta todos los estados salvo `terminated`
vCPU	200	Total entre todas las VMs en ejecución
RAM (GB)	800	Total entre todas las VMs en ejecución
Almacenamiento en bloques (GB)	5.000	Suma de todos los volúmenes (conectados + desconectados)
Almacenamiento de objetos (GB)	ilimitado	Solo es un límite flexible: te contactaremos por encima de ~50 TB para alinear expectativas
Snapshots	200	Por región; los snapshots borrados no cuentan
Backups	500	Por región
IPs flotantes	20	Por región
Redes	10	Por región
Grupos de seguridad	50	Por región
Balanceadores de carga	10	Por región
Zonas DNS	50	A nivel de proyecto
Usuarios	25	A nivel de proyecto

Los valores por defecto son conservadores. A la mayoría de los proyectos de producción se les sube a 5–10× en los ejes más usados (vCPU, RAM, almacenamiento) poco después del lanzamiento.

Cuota frente a consumo

Los endpoints exponen ambas cosas:

GET /v1/quotas — los límites (50 VMs, 200 vCPU, etc.)
GET /v1/quotas/usage — el consumo actual (12 VMs usadas de 50, 48 vCPU de 200, etc.)

Comprueba siempre el consumo antes de crear recursos en bloque; una petición que te haría superar la cuota devuelve un 429 con Retry-After vacío (como la cuota no tiene límite temporal, reintentar no sirve de nada — tienes que borrar algo o aumentar la cuota).

Aumento de cuota

Los aumentos de cuota se tramitan con el formulario de contacto de soporte, no con la API. Tres motivos:

Planificación de capacidad. Los aumentos grandes (10× o más) requieren reservar hardware en la región de destino.
Cumplimiento normativo. Algunos aumentos de cuota requieren una breve conversación sobre la forma de la carga de trabajo.
Prevención de abusos. Un endpoint de autoservicio para aumentar cuotas sería lo primero a lo que llamaría una cuenta comprometida.

La mayoría de los aumentos se resuelven en menos de un día laborable. Las migraciones de producción se resuelven el mismo día si lo indicas en la solicitud.

Cuotas en varias regiones

La mayoría de las cuotas son por región (VMs, snapshots, redes). Unas pocas son a nivel de proyecto (zonas DNS, usuarios). La respuesta del endpoint lo indica explícitamente — cada entrada de cuota lleva un campo scope (region: us-east-1 o project).

Próximos pasos

Proyectos — el contenedor al que se aplican las cuotas.
Autenticación — cómo llamar a estos endpoints.
El formulario de contacto de soporte en /contact/support — donde se tramitan los aumentos de cuota.

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