Server

Server aktualisieren

Teilaktualisierung. Auf einem von einem Agenten gemeldeten Server (`automatic: true`) wird das Schreiben von `name`, `os` oder `manufacturer` mit 422 abgelehnt statt stillschweigend ignoriert: Diese Felder gehören dem Agenten. `type`, `location` und `description` bleiben auf allen Servern editierbar.

Erforderlicher Scope infrastructure:edit

patch/servers/{id}

Authentifizierung

Authorizationstringerforderlich

Authorization-Header mit einem API-Schlüssel des Workspace, in der Form „Bearer kbn_live_…“. Der Header X-Api-Key wird gleichwertig akzeptiert.

Pfadparameter

idstring<uuid>erforderlich

Kennung der Zielressource.

Anfragekörperapplication/json

namestring

Hostname des Servers. Nur manuelle Server.

osstring

Betriebssystem. Nur manuelle Server.

manufacturerstring

Hersteller der Hardware. Nur manuelle Server.

typestring

Typ der Ressource.

locationstring

Physischer Standort.

descriptionstring

Kurze freie Beschreibung.

Antwort200 · application/json

Der aktualisierte Datensatz des Servers.

idstring<uuid>erforderlich

Eindeutige Kennung.

namestringerforderlich

Hostname des Servers.

automaticbooleanerforderlich

Gibt an, ob die Ressource von einem Agenten gemeldet statt manuell angelegt wurde.

systemstring | null

Systemfamilie.

osstring | null

Betriebssystem.

descriptionstring | null

Kurze freie Beschreibung.

criticalitystring | null

Zugewiesene geschäftliche Kritikalität.

modelstring | null

Hardwaremodell.

serialNumberstring | null

Seriennummer der Hardware.

manufacturerstring | null

Hersteller der Hardware.

typestring | null

Typ der Ressource.

locationstring | null

Physischer Standort.

dataCollectionStatusstring | null

Status der Datenerfassung durch den Agenten.

lastCheckTimestring<date-time> | null

Letzte Meldung des Agenten.

uptimenumber | null

Sekunden seit dem letzten Start.

domainstring | null

Domäne, zu der die Maschine gehört.

fqdnstring | null

Vollständig qualifizierter Domänenname.

cpuobject

Prozessor der Maschine.

memorySizenumber | null

Installierter Speicher, in Byte.

disksobject[]

An die Maschine angeschlossene Datenträger.

metricsobject

Letzte Messwerte für CPU, Last, Speicher und Datenträger.

ownersany[]

Für die Ressource verantwortliche Mitglieder.

tagsany[]

Der Ressource zugeordnete Tags.

linkedApplicationsany[]

Auf dem Server gehostete Anwendungen.

interfacesany[]

Netzwerkschnittstellen der Maschine.

customFieldsany[]

Benutzerdefinierte Workspace-Felder und ihre Werte.