Servidores

Crear un servidor

Declara un servidor a mano. Los servidores creados así tienen `automatic: false` y siguen siendo totalmente editables, a diferencia de los detectados por un agente.

Scope requerido infrastructure:add

post/servers

Autenticación

Authorizationstringobligatorio

Cabecera Authorization con una clave de API del espacio de trabajo, con la forma «Bearer kbn_live_…». La cabecera X-Api-Key se acepta de forma equivalente.

Cuerpo de la solicitudapplication/json

namestringobligatorio

Nombre de host del servidor.

osstringobligatorio

Sistema operativo.

ipAddressstringobligatorio

Dirección IP principal del servidor.

manufacturerstring

Fabricante del hardware.

typestring

Tipo del recurso.

locationstring

Ubicación física.

descriptionstring

Breve descripción libre.

Respuesta201 · application/json

El servidor se ha creado.

idstring<uuid>obligatorio

Identificador único.

namestringobligatorio

Nombre de host del servidor.

automaticbooleanobligatorio

Indica si el recurso es detectado por un agente en lugar de declarado a mano.

systemstring | null

Familia de sistema.

osstring | null

Sistema operativo.

descriptionstring | null

Breve descripción libre.

criticalitystring | null

Criticidad de negocio asignada.

modelstring | null

Modelo de hardware.

serialNumberstring | null

Número de serie del hardware.

manufacturerstring | null

Fabricante del hardware.

typestring | null

Tipo del recurso.

locationstring | null

Ubicación física.

dataCollectionStatusstring | null

Estado de la recopilación de datos por el agente.

lastCheckTimestring<date-time> | null

Última comunicación del agente.

uptimenumber | null

Segundos transcurridos desde el último arranque.

domainstring | null

Dominio al que pertenece la máquina.

fqdnstring | null

Nombre de dominio totalmente cualificado.

cpuobject

Procesador de la máquina.

memorySizenumber | null

Memoria instalada, en bytes.

disksobject[]

Discos conectados a la máquina.

metricsobject

Últimas lecturas de CPU, carga, memoria y almacenamiento.

ownersany[]

Miembros responsables del recurso.

tagsany[]

Etiquetas vinculadas al recurso.

linkedApplicationsany[]

Aplicaciones alojadas en el servidor.

interfacesany[]

Interfaces de red de la máquina.

customFieldsany[]

Campos personalizados del espacio de trabajo y sus valores.

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 } ] }