Kategorie: Virtueller Host (Übersicht)#

Die Kategorie Virtueller Host (Übersicht) ist eine Aggregationskategorie, die alle virtualisierungsbezogenen Informationen eines Hypervisors auf einer einzigen Seite zusammenfasst. Sie kombiniert die Inhalte der Kategorien Virtueller Host, Gastsysteme und Virtuelle Switches in einer Gesamtübersicht.

Diese Kategorie enthält keine eigenen, exklusiven Felder — sie fasst Daten zusammen, die in den jeweiligen Unterkategorien gepflegt werden. Änderungen werden nicht direkt in der Übersichtskategorie vorgenommen, sondern in den verlinkten Einzelkategorien. Der Zweck ist ein konsolidierter Blick auf die gesamte Virtualisierungskonfiguration eines Hosts, ohne zwischen mehreren Kategorien wechseln zu müssen.

Verwendung#

Typische Anwendungsfälle:

• Schnellüberblick bei Störungen: Bei einem Host-Ausfall zeigt die Übersichtskategorie auf einen Blick: Ist der Server ein Hypervisor? Welche VMs laufen darauf? Welche virtuellen Switches sind konfiguriert? Diese Informationen sind im Incident-Fall entscheidend — ohne sie muss der Administrator zwischen mehreren Kategorien navigieren und verliert wertvolle Zeit.
• Virtualisierungs-Dokumentation prüfen: Beim Onboarding neuer Hosts oder bei der Qualitätssicherung der CMDB zeigt die Übersicht sofort, ob alle virtualisierungsrelevanten Kategorien gepflegt sind. Ein Host mit Virtueller Host = Ja, aber ohne Gastsysteme und ohne virtuelle Switches, ist entweder noch nicht vollständig dokumentiert oder tatsächlich ein ungenutzter Hypervisor — beides wert, überprüft zu werden.
• Wartungsplanung: Vor einem Wartungsfenster für einen Hypervisor liefert die Übersicht alle relevanten Informationen: die Liste der betroffenen VMs (aus Gastsysteme), den Verwaltungsdienst für die Live-Migration (aus Virtueller Host) und die Netzwerkkonfiguration der VMs (aus Virtuelle Switches).
• Audit und Compliance: In regulierten Umgebungen dient die Übersicht als kompakte Referenz für die gesamte Virtualisierungskonfiguration eines Hosts. Auditoren können auf einer Seite nachvollziehen, welche Workloads auf welcher physischen Hardware laufen und wie die Netzwerktrennung konfiguriert ist.

Enthaltene Kategorien#

Die Übersicht aggregiert folgende Kategorien:

Felder#

Die dargestellten Felder stammen aus den Unterkategorien. Die folgenden Felder werden in der Übersicht angezeigt:

Virtueller Host#

Gibt an, ob das Objekt als Hypervisor fungiert (Ja oder Nein). Stammt aus der Kategorie Virtueller Host.

Lizenzserver#

Verknüpfung zum Lizenzserver-Objekt. Stammt aus der Kategorie Virtueller Host.

Verwaltungsdienst#

Verknüpfung zum Management-System (z.B. vCenter, SCVMM). Stammt aus der Kategorie Virtueller Host.

Beschreibung#

Freitext-Beschreibung. Stammt aus der Kategorie Virtueller Host.

Technische Referenz#

Felder (API-Referenz)#

API-Beispiele#

Eintrag erstellen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__VIRTUAL_HOST_ROOT",
        "data": {
            "virtual_host": 1,
            "license_server": 456,
            "administration_service": 789,
            "description": "Proxmox VE 8.1, Cluster pve-prod-01"
        }
    },
    "id": 1
}

Einträge lesen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.read",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__VIRTUAL_HOST_ROOT"
    },
    "id": 2
}

Eintrag aktualisieren#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__VIRTUAL_HOST_ROOT",
        "entry": 1,
        "data": {
            "virtual_host": 1,
            "description": "Upgrade auf Proxmox VE 8.2 abgeschlossen, 2026-04."
        }
    },
    "id": 3
}