Saltar al contenido
NimbusNexus

Tamaños de VM

Un tamaño de VM es un flavor: un número de vCPUs (vcpus), la RAM en MB (ram) y el swap en MB (swap). No eliges un flavor al crear una VM: fijas spec.cpu y spec.ram, y la API usa un flavor con exactamente esos números, y crea uno si no existe ninguno. El disco de arranque no forma parte del flavor; es un volumen aparte.

Arquitectura y clase de VM

Además de cpu y ram, el spec de una VM indica una architecture y una vm_class. Juntas determinan el producto con el que se factura la VM. Las que se ofrecen en la región de tu sesión están en vm_options de GET /api/v1/instance/artifacts.

Convención de nombres

Lee la configuración de un flavor en vcpus, ram y swap, no en su nombre. Un flavor que la API crea para una VM lleva como nombre su id, un UUID, y lo mismo ocurre con uno creado con POST /api/v1/flavor/ sin name. GET /api/v1/flavor/ filtra por la configuración con min_vcpus, max_vcpus, min_ram, max_ram, min_swap y max_swap.

Los precios dependen de la architecture, la vm_class, la cpu y la ram; consulta Datos de precios.

Redimensionado

Una VM puede cambiar de tamaño sin volver a provisionarse. Envía POST /api/v1/instance/{instance_id}/resize con un spec nuevo (architecture, vm_class, cpu, ram). La VM se reinicia en el flavor nuevo y espera en VERIFY_RESIZE: POST /api/v1/instance/{instance_id}/confirm_resize conserva el tamaño nuevo, y POST /api/v1/instance/{instance_id}/revert_resize vuelve al anterior. Ambas responden 400 si la VM no está en VERIFY_RESIZE.

Próximos pasos

  • Máquinas virtuales — los endpoints que provisionan de verdad una VM con uno de estos tamaños.
  • Imágenes de VM — las plantillas de SO con las que arrancas la VM.
  • Claves SSH — claves públicas inyectadas en las VMs al arrancar.

Reference

GET/api/v1/flavor/

List Flavors

List available compute flavors (instance types defining vCPU, RAM, disk and swap).

Parameters

NameInTypeDescription
min_vcpusqueryinteger | null—
max_vcpusqueryinteger | null—
min_ramqueryinteger | null—
max_ramqueryinteger | null—
min_swapqueryinteger | null—
max_swapqueryinteger | null—
extra_specsqueryarray of string—
vcpu_weightqueryinteger | null—
rxtx_factorquerynumber | null—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/flavor/" \
  -H "Authorization: Bearer $NIMBUS_KEY"
POST/api/v1/flavor/

Create Flavor

Create a new compute flavor definition.

Request body

FieldTypeDescription
vcpus*integer—
ram*integer—
swapinteger | null—
rxtx_factor*number—
extra_specsobject | null—
namestring | null—

Responses

  • 201Successful 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/flavor/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vcpus": 1,
    "ram": 1,
    "rxtx_factor": 0
  }'

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