Kategorie: Freigaben#

Die Kategorie Freigaben dokumentiert die Netzwerkfreigaben (SMB/CIFS-Shares), die ein Server bereitstellt. Sie ist eine Multi-Value-Kategorie — pro Objekt können beliebig viele Freigaben angelegt werden, z.B. für verschiedene Abteilungs- oder Projektlaufwerke auf einem Dateiserver. Die Kategorie erfasst den Freigabenamen, den UNC-Pfad, das zugehörige Volume und den lokalen Pfad auf dem Server.

Verwendung#

Typische Anwendungsfälle:

• Dateiserver-Dokumentation: Erfasse für jeden Share den Freigabenamen, den UNC-Pfad und den lokalen Pfad auf dem Server. So entsteht eine vollständige Übersicht aller Freigaben pro Dateiserver — die Grundlage für Berechtigungsprüfungen, Migrationen und Kapazitätsplanung.
• Migration und Konsolidierung: Bei der Migration von Dateiservern zeigt ein Report über alle Freigaben, welche Shares umgezogen werden müssen. In Kombination mit der Kategorie Freigabezugriff auf den Clients ist sofort klar, welche Benutzer betroffen sind und welche Mountpoints angepasst werden müssen.
• Berechtigungsdokumentation: Im Beschreibungsfeld lassen sich die NTFS- und Share-Berechtigungen dokumentieren — wer hat Lese-, wer Schreibzugriff. Das ist besonders in regulierten Umgebungen wichtig, wo die Zugriffskontrolle nachweisbar sein muss.
• Kapazitätsplanung: Über die Verknüpfung mit dem Volume (Laufwerk) wird ersichtlich, auf welcher Festplatte oder welchem Storage-Volume die Freigabe liegt. Zusammen mit der Kategorie Laufwerk lässt sich die Speicherauslastung pro Share nachvollziehen.

Felder#

Freigabename#

Der Name der Netzwerkfreigabe, z.B. Projekte, Daten$ oder Software. Dieser Wert wird in der Listenansicht und in Reports angezeigt und ist der Name, unter dem der Share im Netzwerk sichtbar ist.

UNC-Pfad#

Der vollständige UNC-Pfad (Universal Naming Convention) der Freigabe, z.B. \\SRV-FILE01\Projekte. Dieser Pfad wird von Clients zum Verbinden der Freigabe verwendet und sollte exakt so eingetragen werden, wie er im Netzwerk erreichbar ist.

Volume#

Verknüpfung zum Laufwerk (Volume) auf dem Server, auf dem die Freigabe physisch liegt. Dialog-Feld, das die in der Kategorie Laufwerk angelegten Volumes zur Auswahl anbietet. So wird die Beziehung zwischen logischer Freigabe und physischem Speicher hergestellt.

Lokaler Pfad#

Der Pfad auf dem Server-Dateisystem, der als Freigabe bereitgestellt wird, z.B. D:\Daten\Projekte oder /srv/samba/projekte. Wichtig für die Administration: Der lokale Pfad zeigt, wo die Daten physisch auf dem Server liegen.

Beschreibung#

Freitext für zusätzliche Angaben: Berechtigungen (NTFS und Share-Level), Quota-Einstellungen, DFS-Namespace-Pfad, Backup-Zugehörigkeit oder besondere Zugriffsregeln.

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
17

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__SHARES",
        "data": {
            "title": "Projekte",
            "unc_path": "\\\\SRV-FILE01\\Projekte",
            "volume": "D:",
            "path": "D:\\Daten\\Projekte",
            "description": "Projektlaufwerk, NTFS: GRP_Projekte_RW (Ändern), GRP_Projekte_RO (Lesen), Quota 500 GB"
        }
    },
    "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__SHARES"
    },
    "id": 2
}

Eintrag aktualisieren#

 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__SHARES",
        "entry": 4,
        "data": {
            "unc_path": "\\\\SRV-FILE02\\Projekte",
            "path": "E:\\Daten\\Projekte",
            "description": "Migration 2025-11: Share von SRV-FILE01 auf SRV-FILE02 umgezogen, neues Volume E:."
        }
    },
    "id": 3
}