Serveurs

Créer un serveur

Déclare un serveur à la main. Les serveurs créés ainsi ont `automatic: false` et restent entièrement modifiables, contrairement à ceux remontés par un agent.

Scope requis infrastructure:add

post/servers

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.

Corps de la requêteapplication/json

namestringobligatoire

Nom d'hôte du serveur.

osstringobligatoire

Système d'exploitation.

ipAddressstringobligatoire

Adresse IP principale du serveur.

manufacturerstring

Fabricant du matériel.

typestring

Type de la ressource.

locationstring

Emplacement physique.

descriptionstring

Courte description libre.

Réponse201 · application/json

Le serveur a été créé.

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.

curl --request POST \ --url https://app.kabeen.io/public/v1/servers \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "<string>", "os": "<string>", "ipAddress": "<string>", "manufacturer": "<string>", "type": "<string>", "location": "<string>", "description": "<string>" }'

{ "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>", "automatic": true, "system": "<string>", "os": "<string>", "description": "<string>", "criticality": "<string>", "model": "<string>", "serialNumber": "<string>", "manufacturer": "<string>", "type": "<string>", "location": "<string>", "dataCollectionStatus": "<string>", "lastCheckTime": "2026-09-01T09:12:03Z", "uptime": 123, "domain": "<string>", "fqdn": "<string>", "cpu": { "model": "<string>", "count": 123, "coreCount": 123 }, "memorySize": 123, "disks": [ {} ], "metrics": {}, "owners": [ { "accountId": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "email": "<string>", "firstName": "<string>", "lastName": "<string>", "role": "<string>" } ], "tags": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>" } ], "linkedApplications": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>" } ], "interfaces": [ { "ipAddress": "<string>", "primary": true, "network": { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>" } } ], "customFields": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "name": "<string>", "type": "text", "description": "<string>", "value": null } ] }