Regiones y stock
Cómo Cloud API decide dónde colocar un servidor entre todas las instancias y nodos.
Disponibilidad de regiones
GET /v1/regions resume la capacidad desplegable por región:
json{ "regions": [ { "region": "USA", "freeMemory": 131072, "freeSlots": 48, "unlimited": false, "deployable": true }, { "region": "SPAIN", "freeMemory": 65536, "freeSlots": 20, "unlimited": false, "deployable": true } ] }
Una región es deployable cuando al menos un nodo activo (no en mantenimiento) tiene una asignación libre y ≥256 MB de memoria libre. unlimited es true cuando un nodo no tiene límite de capacidad configurado.
El motor de stock
El motor sigue las reglas de viabilidad del panel:
- Un límite de nodo de 0 significa ilimitado para esa dimensión.
- Una sobreasignación de -1 también significa ilimitado.
- De lo contrario, la capacidad efectiva = límite × (1 + sobreasignación%).
- Cuando un nodo no tiene sobreasignación configurada, se aplica el valor predeterminado de la plataforma (50%).
- El uso se calcula desde los límites reales de construcción del servidor en cada nodo.
Colocación
Al desplegar, Cloud API filtra a nodos que:
- no estén en mantenimiento,
- tengan suficiente memoria libre, disco y CPU para la petición,
- tengan al menos una asignación libre,
- coincidan con la región solicitada (si la hay).
Los candidatos se ordenan por prioridad de instancia, luego por mayor memoria libre. Pasar region: null deja al motor elegir la mejor región globalmente.