/// 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"
}
]
}