Serveurs

Mettre à jour un serveur

Mise à jour partielle. Sur un serveur remonté par un agent (`automatic: true`), écrire `name`, `os` ou `manufacturer` est rejeté par un 422 plutôt que silencieusement ignoré : ces champs appartiennent à l'agent. `type`, `location` et `description` restent modifiables sur tous les serveurs.

Scope requis infrastructure:edit

patch/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.

Corps de la requêteapplication/json

namestring

Nom d'hôte du serveur. Serveurs manuels uniquement.

osstring

Système d'exploitation. Serveurs manuels uniquement.

manufacturerstring

Fabricant du matériel. Serveurs manuels uniquement.

typestring

Type de la ressource.

locationstring

Emplacement physique.

descriptionstring

Courte description libre.

Réponse200 · application/json

La fiche mise à jour 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.

curl --request PATCH \ --url https://app.kabeen.io/public/v1/servers/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "<string>", "os": "<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 } ] }