Servidores

Actualizar un servidor

Actualización parcial. En un servidor detectado por un agente (`automatic: true`), escribir `name`, `os` o `manufacturer` se rechaza con un 422 en lugar de ignorarse silenciosamente: esos campos pertenecen al agente. `type`, `location` y `description` siguen siendo editables en todos los servidores.

Scope requerido infrastructure:edit

patch/servers/{id}

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.

Parámetros de ruta

idstring<uuid>obligatorio

Identificador del recurso objetivo.

Cuerpo de la solicitudapplication/json

namestring

Nombre de host del servidor. Solo servidores manuales.

osstring

Sistema operativo. Solo servidores manuales.

manufacturerstring

Fabricante del hardware. Solo servidores manuales.

typestring

Tipo del recurso.

locationstring

Ubicación física.

descriptionstring

Breve descripción libre.

Respuesta200 · application/json

La ficha actualizada del servidor.

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.