Wie lege ich ein VLAN an?

Ab Tarif Basic

Kurzantwort

Im Modul Netzwerk wechselst du in den Reiter VLANs und klickst auf „VLAN hinzufügen”. Pflicht sind die VLAN-ID (1 bis 4094) und ein Name. Optional ordnest du das VLAN einer VLAN-Gruppe zu und hinterlegst eine Beschreibung.

Voraussetzungen

Enthalten in allen Tarifen ab Basic.

Reiter „VLANs” öffnen. Wähle Netzwerk und dann den Reiter VLANs. Klicke auf „VLAN hinzufügen”.

Screenshot ausstehend netzwerk-vlan-01 Reiter 'VLANs' im Modul Netzwerk mit dem Formular für ein neues VLAN

Der Reiter 'VLANs' mit dem Formular für ein neues VLAN.
Formular ausfüllen.
- VLAN-ID: Zahl zwischen 1 und 4094 (z. B. 10)
- VLAN-Name: z. B. „Management”
- VLAN-Gruppe (optional): Auswahl einer vorhandenen Gruppe
- Beschreibung (optional)
Möchtest du VLANs bündeln, lege zuvor über Hinzufügen eine VLAN-Gruppe an (nur ein Name nötig) und wähle sie hier aus.
Speichern. Das VLAN erscheint in der Liste, aufsteigend nach VLAN-ID sortiert.

Per REST-API: ein POST auf /api/v1/network/vlans. Pflicht sind vlan_id und name.

curl -X POST https://demo.notory.io/api/v1/network/vlans \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "vlan_id": 10,
    "name": "Management",
    "description": "Out-of-Band Management"
  }'

{
  "id": "0190f3a2-8e33-7dab-b2c4-3e6f7a8b9c02",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "vlan_id": 10,
  "name": "Management",
  "description": "Out-of-Band Management",
  "group_id": null,
  "created_at": "2026-07-08T09:30:00Z",
  "updated_at": "2026-07-08T09:30:00Z"
}

Eine VLAN-Gruppe legst du separat an (POST /api/v1/network/vlan-groups, nur name) und referenzierst ihre id beim VLAN über group_id.

Mögliche Fehler: 401, 403 (Rechte/Rolle), 422 (Validierung: z. B. vlan_id außerhalb 1 bis 4094 oder leerer name).

Was passiert dabei?

Mandanten-Zuordnung: Das VLAN gehört deinem aktuellen Mandanten.
ID-Validierung: Die VLAN-ID muss im Bereich 1 bis 4094 liegen; andernfalls lehnt Notory die Anlage mit 422 ab. Die ID ist indiziert, aber nicht erzwungen eindeutig. Dieselbe Nummer kann mehrfach vorkommen.
Gruppen-Bezug: Wird die verknüpfte VLAN-Gruppe gelöscht, setzt Notory group_id auf null (SET NULL); das VLAN bleibt bestehen.
Nutzung: VLANs stehen anschließend als Auswahl bei IP-Adressen und IP-Bereichen zur Verfügung.