Ir a la documentación
DocumentaciónReferencia de la APIConsultar un servidor
GETToken Bearer

Consultar un servidor

/api/v1/servers/:id

Consulta los detalles del servidor sin credenciales. instanceId es el identificador del proveedor, no el identificador de la plataforma usado en las rutas API.

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" \
  -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 sin devolver credenciales de acceso.

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.

firewallsnull

Consulte las asociaciones de firewall mediante get_server_resources.