ovahub
Ir a la documentación
DocumentaciónReferencia de la APIConsultar recursos del servidor
GETToken Bearer

Consultar recursos del servidor

/api/v1/servers/:id/resources

Consulta los detalles del servidor y los cortafuegos asociados. firewallState distingue entre vista previa, pendiente de sincronización y listo. firewalls con valor null no confirma que no haya cortafuegos asociados.

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
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/resources" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Solo ejemplos. Esta página no envía peticiones.

Parámetros

idRuta · Obligatorio

string

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.

Respuesta

Estado HTTP 200

Consulta los detalles del servidor guardados en la plataforma y el estado guardado actual de sus asociaciones de firewall.

testOnlyboolean

Indica si este servidor es un recurso de prueba aislado.

testUntilstring (ISO 8601) | null

Vencimiento del recurso de prueba, si existe.

supplierPaidThroughstring (ISO 8601) | null

Valor expiresAt guardado del servidor; se devuelve con este nombre de campo histórico.

instanceIdstring

Identificador de instancia del proveedor, no el ObjectId del servidor de la plataforma.

namestring

Nombre de host guardado, o una cadena vacía.

statusstring

Estado guardado del servidor.

previewboolean

Indica si el servidor es una vista previa de solo lectura.

regionstring

Nombre visible de la región; si no existe, se usa su código.

dataCenterstring

Actualmente contiene una raya como marcador de posición.

productstring

Nombre de producto guardado; si no existe, se muestra una raya.

cpunumber

Número de CPU guardado, o cero.

memoryMbnumber

Memoria guardada en MB, o cero.

diskMbnumber

Capacidad de disco guardada en MB, o cero.

operatingSystemstring

Nombre o identificador guardado del sistema operativo; si no existe, se muestra una raya.

imageIdnull

La consulta actual de detalles guardados en la plataforma no rellena este campo.

ipv4string | null

Dirección IPv4 guardada, si existe.

ipv6string | null

Dirección IPv6 guardada, si existe.

macAddressstring

Dirección MAC guardada, o una cadena vacía.

createdAtstring (ISO 8601) | null

Fecha y hora guardadas de creación de la compra, si existen.

additionalIpsnull

La consulta actual de detalles guardados en la plataforma no rellena este campo.

privateNetworksnull

La consulta actual de detalles guardados en la plataforma no rellena este campo.

firewallStatestring ('preview' | 'unsynced' | 'ready')

Indica si hay datos de firewall disponibles para este servidor.

firewallsarray | null

Null en los estados preview o unsynced; en los demás casos, las asociaciones correspondientes.

firewalls[].idstring

Identificador de firewall del proveedor; no necesariamente coincide con el identificador de la plataforma.

firewalls[].namestring

Nombre para mostrar del firewall.

firewalls[].statusstring

Estado del firewall en el proveedor.

firewalls[].attachedInstanceCountnumber

Número de servidores visibles de la organización asociados.

firewalls[].rulesarray

Reglas con displayName, protocol, destPorts, ipv4, ipv6, action y status.

Relacionado

Peticiones y erroresAutenticaciónMCP · get_server_resources