Wie lege ich eine IP-Adresse an?

Ab Tarif Basic

Kurzantwort

Öffne das Modul Netzwerk, bleibe im Reiter IP-Adressen und klicke auf „IP-Adresse hinzufügen”. Pflicht ist nur die Adresse selbst. Alle weiteren Angaben (Subnetzmaske, Gateway, DNS-Name, VLAN, Status, zugewiesenes Asset) sind optional. Ohne Angabe steht der Status auf Verfügbar.

Voraussetzungen

Das Netzwerk-Modul ist im Kern enthalten und in allen Tarifen ab Basic verfügbar; für IP-Adressen gibt es kein gesondertes Mengenlimit.

Modul „Netzwerk” öffnen. Wähle in der linken Navigation Netzwerk. Der Reiter IP-Adressen ist bereits aktiv. Oben liegt die Schaltfläche „IP-Adresse hinzufügen”.

Screenshot ausstehend netzwerk-ip-01 Reiter 'IP-Adressen' im Modul Netzwerk mit der Schaltfläche 'IP-Adresse hinzufügen'

Der Reiter 'IP-Adressen' mit der Schaltfläche 'IP-Adresse hinzufügen'.
Formular ausfüllen. Trage mindestens die Adresse ein (z. B. 10.0.0.1). Optional, aber empfohlen:
- Subnetzmaske: z. B. 255.255.255.0
- Gateway: z. B. 10.0.0.254
- DNS-Name: z. B. srv-fileserver.intern
- VLAN-ID: Auswahl aus deinen VLANs
- Status: Verfügbar (Standard), Zugewiesen, Reserviert oder Veraltet
- Zugewiesenes Asset: das Gerät, das die Adresse nutzt
- Beschreibung
Screenshot ausstehend netzwerk-ip-02 Formular 'IP-Adresse hinzufügen' mit Feldern Adresse, Subnetzmaske, Gateway, DNS-Name, VLAN, Status

Das Formular für eine neue IP-Adresse. Pflicht ist nur die Adresse.
Speichern. Die Adresse erscheint sofort in der Liste, sortiert nach Adresse. Über das Zeilenmenü kannst du sie später bearbeiten oder löschen.

Dieselbe Aktion per REST-API: ein POST auf /api/v1/network/ips mit einem Bearer-Token (Scope write). Nur address ist Pflicht.

curl -X POST https://demo.notory.io/api/v1/network/ips \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "10.0.0.10",
    "subnet_mask": "255.255.255.0",
    "gateway": "10.0.0.254",
    "dns_name": "srv-fileserver.intern",
    "status": "reserved",
    "description": "Reserviert für neuen Fileserver"
  }'

Bei Erfolg antwortet die API mit HTTP 201 Created:

{
  "id": "0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a80",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "address": "10.0.0.10",
  "subnet_mask": "255.255.255.0",
  "gateway": "10.0.0.254",
  "vlan_id": null,
  "dns_name": "srv-fileserver.intern",
  "status": "reserved",
  "assigned_asset_id": null,
  "description": "Reserviert für neuen Fileserver",
  "created_at": "2026-07-08T09:20:00Z",
  "updated_at": "2026-07-08T09:20:00Z"
}

Zum Ändern dient PUT /api/v1/network/ips/{id} (nur die gesendeten Felder werden überschrieben), zum Löschen DELETE /api/v1/network/ips/{id} (nur Administrator).

Mögliche Fehler: 401 (Token fehlt/ungültig), 403 (kein Schreibrecht bzw. beim Löschen keine Administrator-Rolle), 422 (Validierung: z. B. leere address oder unbekannter status).

Was passiert dabei?

Mandanten-Zuordnung: Die Adresse wird deinem aktuellen Mandanten zugeordnet (tenant_id) und ist für andere Mandanten unsichtbar.
Audit-Trail: Notory vermerkt intern Ersteller und letzten Bearbeiter (created_by/updated_by) samt Zeitstempeln. Als einziges Netzwerk-Objekt führt die IP-Adresse diese Nutzerspur.
Standardstatus: Ohne Angabe gilt status = Verfügbar. Der Status ist reine Dokumentation und steuert, wie die Adresse in Listen und bei der Suche nach freien IPs erscheint.
Keine Eindeutigkeitsprüfung: Notory erzwingt keine Unique-Regel auf die Adresse und erkennt Doppelvergaben nicht automatisch. Dieselbe IP lässt sich technisch mehrfach erfassen. Nutze konsequent das Statusfeld (Verfügbar/Zugewiesen/ Reserviert), um Belegungen sauber zu steuern.
Verknüpfungen bleiben stabil: Wird das zugewiesene Asset oder das verknüpfte VLAN später gelöscht, setzt Notory die Verknüpfung auf null (SET NULL). Die IP-Adresse selbst bleibt erhalten.