/// COMPUTE API v2.0

Gestión de Instancias

El recurso de instancias permite desplegar, reiniciar, detener y destruir servidores virtuales dentro de su VPC de manera programática.

Listar Instancias Activas

Retorna una lista paginada de todos los servidores virtuales aprovisionados bajo el Tenant actual. Puede filtrar por estado o red.

GET https://api.corpohosting.com/v2/instances

Desplegar Instancia

Aprovisiona un nuevo servidor virtual basado en una imagen de SO, un Flavor específico (CPU/RAM) y lo asigna a una subred de su VPC.

POST https://api.corpohosting.com/v2/instances

Petición de Ejemplo (cURL)

curl -X POST https://api.corpohosting.com/v2/instances \
  -H "Authorization: Bearer sk_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "erp-node-01",
    "flavor_id": "FLV-MO-8GB",
    "image_id": "ubuntu-24-04-lts",
    "vpc_id": "vpc-8f92a3",
    "ssh_keys": ["key-2b4c5"]
  }'

Respuesta Estructurada (JSON)

{
  "id": "inst-c7d8e9",
  "name": "erp-node-01",
  "status": "PROVISIONING",
  "created_at": "2026-05-01T17:20:27Z",
  "networks": [
    {
      "type": "private",
      "ipv4": "10.0.1.15"
    }
  ]
}