ovahubComprobar red para un servidor nuevo
/api/v1/networks/:id/order-check
Compara una red de la organización con un plan local de Contabo y cuenta las plazas locales activas. Si la red o el plan no existen, devuelve 404. No es una cotización, una reserva ni una garantía de compatibilidad.
Antes de llamar
Solo lectura local, sin solicitudes al proveedor, cobros ni escrituras. Todas las capabilities son false; coincidir en región o proveedor no demuestra compatibilidad ni conexión segura.
Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.
Ejemplo de petición
curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/order-check?planId=V153®ion=EU" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
Respuesta ilustrativa
{
"networkId": "507f1f77bcf86cd799439011",
"source": "local",
"regionMatch": true,
"providerMatch": true,
"eligible": false,
"testOnly": true,
"capabilities": {
"purchase": false,
"attach": false,
"disconnect": false,
"remove": false,
"reconnect": false,
"cancelAddon": false,
"renew": false,
"resize": false,
"delete": false,
"blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
},
"blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment.",
"planId": "V153",
"region": "EU",
"networkState": "ready",
"verification": "unknown",
"capacity": {
"total": 5,
"localOccupied": 2,
"localRemaining": 3,
"networkVersion": 1,
"verification": "snapshot"
},
"compatibility": "unknown",
"supplierCost": "unknown",
"reserved": false
}Parámetros
idRuta · Obligatoriostring
ID del recurso: 24 caracteres hexadecimales. Use el ID de la plataforma devuelto por el endpoint de listado correspondiente, no el ID de instancia del proveedor.
planIdConsulta · Obligatoriostring
ID del plan local de Contabo: 1–100 letras, dígitos, guiones bajos o guiones. No se consulta el catálogo del proveedor.
regionConsulta · Obligatoriostring
Región del plan local: 2–40 letras, dígitos, guiones bajos o guiones. La combinación exacta de proveedor, plan y región debe existir localmente.
Respuesta
Estado HTTP 200
Compara una red de la organización con un plan local de Contabo y cuenta las plazas locales activas. Si la red o el plan no existen, devuelve 404. No es una cotización, una reserva ni una garantía de compatibilidad.
networkIdstringIdentificador de la plataforma, no del proveedor.
planIdstringID del plan local de Contabo: 1–100 letras, dígitos, guiones bajos o guiones. No se consulta el catálogo del proveedor.
regionstringRegión del plan local: 2–40 letras, dígitos, guiones bajos o guiones. La combinación exacta de proveedor, plan y región debe existir localmente.
source"local"Siempre local; no se realiza ninguna consulta en vivo al proveedor.
regionMatchbooleanSolo comparación local; true no demuestra compatibilidad ni conexión segura.
providerMatchbooleanSolo comparación local; true no demuestra compatibilidad ni conexión segura.
networkStatestringValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
verification"unknown"Siempre unknown; no se han verificado la compatibilidad del producto y del centro de datos, la capacidad del proveedor, los complementos necesarios ni el coste.
capacityobjectSolo capacidad local: total es un tamaño conocido del catálogo o null. Los recuentos incluyen todas las plazas activas reserved, assigned y releasing, también las desconectadas. Los datos corruptos, el exceso de plazas o un cambio de versión de red dejan ambos recuentos en null. La instantánea no reserva plazas ni demuestra capacidad del proveedor.
capacity.totalinteger | nullSolo capacidad local: total es un tamaño conocido del catálogo o null. Los recuentos incluyen todas las plazas activas reserved, assigned y releasing, también las desconectadas. Los datos corruptos, el exceso de plazas o un cambio de versión de red dejan ambos recuentos en null. La instantánea no reserva plazas ni demuestra capacidad del proveedor.
capacity.localOccupiedinteger | nullSolo capacidad local: total es un tamaño conocido del catálogo o null. Los recuentos incluyen todas las plazas activas reserved, assigned y releasing, también las desconectadas. Los datos corruptos, el exceso de plazas o un cambio de versión de red dejan ambos recuentos en null. La instantánea no reserva plazas ni demuestra capacidad del proveedor.
capacity.localRemaininginteger | nullSolo capacidad local: total es un tamaño conocido del catálogo o null. Los recuentos incluyen todas las plazas activas reserved, assigned y releasing, también las desconectadas. Los datos corruptos, el exceso de plazas o un cambio de versión de red dejan ambos recuentos en null. La instantánea no reserva plazas ni demuestra capacidad del proveedor.
capacity.networkVersioninteger | nullSolo capacidad local: total es un tamaño conocido del catálogo o null. Los recuentos incluyen todas las plazas activas reserved, assigned y releasing, también las desconectadas. Los datos corruptos, el exceso de plazas o un cambio de versión de red dejan ambos recuentos en null. La instantánea no reserva plazas ni demuestra capacidad del proveedor.
capacity.verification"snapshot" | "unknown"Solo capacidad local: total es un tamaño conocido del catálogo o null. Los recuentos incluyen todas las plazas activas reserved, assigned y releasing, también las desconectadas. Los datos corruptos, el exceso de plazas o un cambio de versión de red dejan ambos recuentos en null. La instantánea no reserva plazas ni demuestra capacidad del proveedor.
compatibility"unknown"Siempre unknown; no se han verificado la compatibilidad del producto y del centro de datos, la capacidad del proveedor, los complementos necesarios ni el coste.
supplierCost"unknown"Siempre unknown; no se han verificado la compatibilidad del producto y del centro de datos, la capacidad del proveedor, los complementos necesarios ni el coste.
eligiblefalseSolo lectura local, sin solicitudes al proveedor, cobros ni escrituras. Todas las capabilities son false; coincidir en región o proveedor no demuestra compatibilidad ni conexión segura.
reservedfalseSolo lectura local, sin solicitudes al proveedor, cobros ni escrituras. Todas las capabilities son false; coincidir en región o proveedor no demuestra compatibilidad ni conexión segura.
testOnlybooleanTrue solo marca un contexto de prueba, que puede incluir servidores reales comprados. No demuestra simulación ni omite cobros o controles de seguridad.
capabilitiesobjectLos nueve indicadores son false: purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize y delete. Las capacidades del proveedor aún no están verificadas y no se cobra hasta verificarlas; las instantáneas no prueban compatibilidad ni conexión segura.
blockedReasonstringSolo lectura local, sin solicitudes al proveedor, cobros ni escrituras. Todas las capabilities son false; coincidir en región o proveedor no demuestra compatibilidad ni conexión segura.