Serveurs

Récupérer un serveur

La fiche complète d'un serveur : son matériel, ses dernières métriques, ses interfaces, ses responsables et les applications qu'il héberge.

Scope requis infrastructure:read

get/servers/{id}

Authentification

Authorizationstringobligatoire

En-tête Authorization portant une clé d'API de l'espace de travail, sous la forme « Bearer kbn_live_… ». L'en-tête X-Api-Key est accepté de façon équivalente.

Paramètres de chemin

idstring<uuid>obligatoire

Identifiant de la ressource visée.

Réponse200 · application/json

La fiche du serveur.

idstring<uuid>obligatoire

Identifiant unique.

namestringobligatoire

Nom d'hôte du serveur.

automaticbooleanobligatoire

Indique si la ressource est remontée par un agent plutôt que déclarée à la main.

systemstring | null

Famille de système.

osstring | null

Système d'exploitation.

descriptionstring | null

Courte description libre.

criticalitystring | null

Criticité métier attribuée.

modelstring | null

Modèle matériel.

serialNumberstring | null

Numéro de série du matériel.

manufacturerstring | null

Fabricant du matériel.

typestring | null

Type de la ressource.

locationstring | null

Emplacement physique.

dataCollectionStatusstring | null

État de la collecte de données par l'agent.

lastCheckTimestring<date-time> | null

Dernière remontée de l'agent.

uptimenumber | null

Secondes écoulées depuis le dernier démarrage.

domainstring | null

Domaine auquel la machine appartient.

fqdnstring | null

Nom de domaine pleinement qualifié.

cpuobject

Processeur de la machine.

memorySizenumber | null

Mémoire installée, en octets.

disksobject[]

Disques attachés à la machine.

metricsobject

Derniers relevés CPU, charge, mémoire et stockage.

ownersany[]

Membres responsables de la ressource.

tagsany[]

Tags attachés à la ressource.

linkedApplicationsany[]

Applications hébergées sur le serveur.

interfacesany[]

Interfaces réseau de la machine.

customFieldsany[]

Champs personnalisés de l'espace de travail et leurs valeurs.