ovahubConsultar redes privadas del servidor
/api/v1/servers/:id/networks
Lee hasta 100 registros locales de puertos del servidor actual de la organización y su instancia física. Los servidores inexistentes, eliminados o transferidos devuelven 404. Una identidad física inválida devuelve 409. La ausencia de registros no demuestra aislamiento ni el fin de la facturació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/servers/undefined/networks" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
Respuesta ilustrativa
{
"serverId": "507f1f77bcf86cd799439013",
"ports": [],
"nextCursor": null,
"testOnly": false,
"source": "local",
"verification": "unknown",
"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."
}
}Parámetros
idRuta · Obligatoriostring
ID de servidor de la organización actual: 24 caracteres hexadecimales. Los servidores eliminados o transferidos no son accesibles.
afterConsulta · Opcionalstring
Cursor opcional de puerto de 24 caracteres hexadecimales obtenido de nextCursor. Devuelve IDs de puerto mayores que el cursor, hasta 100 registros; null indica que no hay otra página.
Respuesta
Estado HTTP 200
Lee hasta 100 registros locales de puertos del servidor actual de la organización y su instancia física. Los servidores inexistentes, eliminados o transferidos devuelven 404. Una identidad física inválida devuelve 409. La ausencia de registros no demuestra aislamiento ni el fin de la facturación.
serverIdstringID de servidor de la organización actual: 24 caracteres hexadecimales. Los servidores eliminados o transferidos no son accesibles.
testOnlybooleanTrue solo marca un contexto de prueba, que puede incluir servidores reales comprados. No demuestra simulación ni omite cobros o controles de seguridad.
portsobject[]Lee hasta 100 registros locales de puertos del servidor actual de la organización y su instancia física. Los servidores inexistentes, eliminados o transferidos devuelven 404. Una identidad física inválida devuelve 409. La ausencia de registros no demuestra aislamiento ni el fin de la facturación.
ports[].idstringIdentificador de la plataforma, no del proveedor.
ports[].slotintegerValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].serverIdstringID de servidor de la organización actual: 24 caracteres hexadecimales. Los servidores eliminados o transferidos no son accesibles.
ports[].activebooleanValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].reservationStatestringValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].connectionStatestringLos datos de conexión e IP requieren una red coincidente de la organización y una fecha de comprobación válida que no sea futura. En caso contrario, connectionState es unknown y checkedAt/privateIps son null. Solo son instantáneas locales.
ports[].privateIpsstring[] | nullLos datos de conexión e IP requieren una red coincidente de la organización y una fecha de comprobación válida que no sea futura. En caso contrario, connectionState es unknown y checkedAt/privateIps son null. Solo son instantáneas locales.
ports[].checkedAtstring | nullLos datos de conexión e IP requieren una red coincidente de la organización y una fecha de comprobación válida que no sea futura. En caso contrario, connectionState es unknown y checkedAt/privateIps son null. Solo son instantáneas locales.
ports[].versionintegerValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].testOnlybooleanTrue solo marca un contexto de prueba, que puede incluir servidores reales comprados. No demuestra simulación ni omite cobros o controles de seguridad.
ports[].networkobject | nullInstantánea de una red de la organización con los campos de list_networks, o null si no está disponible o su contexto de prueba difiere del servidor o del puerto.
ports[].network.cidrstring | nullCIDR privado registrado, o null si no se ha observado.
ports[].network.boundServersinteger | nullNúmero de conexiones activas a servidores físicos actuales de la organización; null si el recuento es incoherente.
ports[].network.occupiedPortsinteger | nullReservas locales activas, incluidas las pendientes y en proceso de retirada; null si la ocupación es incoherente.
ports[].network.idstringIdentificador de la plataforma, no del proveedor.
ports[].network.providerstringValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.namestringValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.regionstringValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.dataCenterstring | nullValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.capacityintegerValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.statestringValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.versionintegerValor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.
ports[].network.monthlyPricestringCentavos enteros de USD como cadena, no dólares; un precio publicado no habilita el pago.
ports[].network.serviceFromstring (ISO 8601) | nullEl servicio empieza solo tras confirmar la compra; null si se desconoce.
ports[].network.serviceUntilstring (ISO 8601) | nullFin del servicio pagado en la plataforma, independiente de las fechas pagadas al proveedor; null si se desconoce.
ports[].network.autoRenewbooleanSolo es una preferencia de renovación; no demuestra pago ni ampliación.
ports[].network.accessStatestringEstado local guardado del acceso a la red: active, stopping, stopped, restoring o unknown. No verifica la conectividad actual del proveedor.
ports[].network.currency"USD"Moneda fija USD, unidad cent y período month cuando se incluye.
ports[].network.priceUnit"cent"Moneda fija USD, unidad cent y período month cuando se incluye.
ports[].network.checkedAtstring | nullFecha de comprobación de la instantánea en ISO 8601, o null si se desconoce. No es una verificación en vivo.
ports[].network.testOnlybooleanTrue solo marca un contexto de prueba, que puede incluir servidores reales comprados. No demuestra simulación ni omite cobros o controles de seguridad.
ports[].network.source"local"Siempre local; no se realiza ninguna consulta en vivo al proveedor.
ports[].network.verification"unknown" | "snapshot"snapshot si existe checkedAt; de lo contrario, unknown. Ninguno verifica el estado actual del proveedor.
ports[].network.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.
nextCursorstring | nullCursor opcional de puerto de 24 caracteres hexadecimales obtenido de nextCursor. Devuelve IDs de puerto mayores que el cursor, hasta 100 registros; null indica que no hay otra página.
source"local"Siempre local; no se realiza ninguna consulta en vivo al proveedor.
verification"unknown"Siempre unknown; un resultado local vacío no prueba ausencia en el proveedor.
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.