ovahubComprobar conexión a una red privada
/api/v1/networks/:id/attach-check
Compare la región y el proveedor locales de una red propia y un servidor actual no eliminado de la organización. Los recursos inexistentes o ajenos devuelven 404. Esta comprobación nunca autoriza la conexión.
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/attach-check?serverId=507f1f77bcf86cd799439013" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
Respuesta ilustrativa
{
"networkId": "507f1f77bcf86cd799439011",
"serverId": "507f1f77bcf86cd799439013",
"source": "local",
"regionMatch": true,
"providerMatch": true,
"eligible": false,
"requiresRestart": "unknown",
"requiresReinstall": "unknown",
"ipChange": "unknown",
"addon": {
"state": "unknown",
"checkedAt": null,
"cancelEffectiveAt": null,
"verification": "unknown"
},
"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."
}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.
serverIdConsulta · Obligatoriostring
ID de servidor de la organización actual: 24 caracteres hexadecimales. Los servidores eliminados o transferidos no son accesibles.
Respuesta
Estado HTTP 200
Compare la región y el proveedor locales de una red propia y un servidor actual no eliminado de la organización. Los recursos inexistentes o ajenos devuelven 404. Esta comprobación nunca autoriza la conexión.
networkIdstringIdentificador de la plataforma, no del proveedor.
serverIdstringIdentificador de la plataforma, no del proveedor.
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.
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.
requiresRestart"unknown"Siempre unknown; no se han verificado los efectos de reinicio, reinstalación o cambio de IP.
requiresReinstall"unknown"Siempre unknown; no se han verificado los efectos de reinicio, reinstalación o cambio de IP.
ipChange"unknown"Siempre unknown; no se han verificado los efectos de reinicio, reinstalación o cambio de IP.
addonobjectInstantánea local del complemento tras verificar la propiedad. Sin checkedAt válido: state unknown, ambas fechas null y verification unknown. Una instantánea comprobada tiene verification snapshot; cancel_pending no demuestra cancelación ni exención del próximo cobro.
addon.statestringInstantánea local del complemento tras verificar la propiedad. Sin checkedAt válido: state unknown, ambas fechas null y verification unknown. Una instantánea comprobada tiene verification snapshot; cancel_pending no demuestra cancelación ni exención del próximo cobro.
addon.checkedAtstring | nullFecha de comprobación de la instantánea en ISO 8601, o null si se desconoce. No es una verificación en vivo.
addon.cancelEffectiveAtstring | nullInstantánea local del complemento tras verificar la propiedad. Sin checkedAt válido: state unknown, ambas fechas null y verification unknown. Una instantánea comprobada tiene verification snapshot; cancel_pending no demuestra cancelación ni exención del próximo cobro.
addon.verification"unknown" | "snapshot"Instantánea local del complemento tras verificar la propiedad. Sin checkedAt válido: state unknown, ambas fechas null y verification unknown. Una instantánea comprobada tiene verification snapshot; cancel_pending no demuestra cancelación ni exención del próximo cobro.
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.