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.

Regions & stock | Enzonic Cloud API