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 "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
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.
Respuesta
Estado HTTP 200
Consulta los detalles del servidor guardados en la plataforma sin devolver credenciales de acceso.
testOnlybooleanIndica si este servidor es un recurso de prueba aislado.
testUntilstring (ISO 8601) | nullVencimiento del recurso de prueba, si existe.
supplierPaidThroughstring (ISO 8601) | nullValor expiresAt guardado del servidor; se devuelve con este nombre de campo histórico.
instanceIdstringIdentificador de instancia del proveedor, no el ObjectId del servidor de la plataforma.
namestringNombre de host guardado, o una cadena vacía.
statusstringEstado guardado del servidor.
previewbooleanIndica si el servidor es una vista previa de solo lectura.
regionstringNombre visible de la región; si no existe, se usa su código.
dataCenterstringActualmente contiene una raya como marcador de posición.
productstringNombre de producto guardado; si no existe, se muestra una raya.
cpunumberNúmero de CPU guardado, o cero.
memoryMbnumberMemoria guardada en MB, o cero.
diskMbnumberCapacidad de disco guardada en MB, o cero.
operatingSystemstringNombre o identificador guardado del sistema operativo; si no existe, se muestra una raya.
imageIdnullLa consulta actual de detalles guardados en la plataforma no rellena este campo.
ipv4string | nullDirección IPv4 guardada, si existe.
ipv6string | nullDirección IPv6 guardada, si existe.
macAddressstringDirección MAC guardada, o una cadena vacía.
createdAtstring (ISO 8601) | nullFecha y hora guardadas de creación de la compra, si existen.
additionalIpsnullLa consulta actual de detalles guardados en la plataforma no rellena este campo.
privateNetworksnullLa consulta actual de detalles guardados en la plataforma no rellena este campo.
firewallsnullConsulte las asociaciones de firewall mediante get_server_resources.