Wie ordne ich eine IP-Adresse einem Asset zu?

Ab Tarif Basic

Kurzantwort

Öffne im Modul Netzwerk die betreffende IP-Adresse zum Bearbeiten, wähle unter Zugewiesenes Asset das Gerät aus und setze den Status auf Zugewiesen. Beide Felder kannst du auch direkt beim Anlegen der Adresse befüllen.

Voraussetzungen

Enthalten in allen Tarifen ab Basic.

IP-Adresse zum Bearbeiten öffnen. Wähle Netzwerk → IP-Adressen und öffne über das Zeilenmenü die gewünschte Adresse (oder lege sie neu an).
Asset und Status setzen.
- Zugewiesenes Asset: wähle das Gerät aus, das die Adresse nutzt.
- Status: setze ihn auf Zugewiesen.
Screenshot ausstehend netzwerk-ip-zuordnen-01 Formular einer IP-Adresse mit ausgewähltem 'Zugewiesenes Asset' und Status 'Zugewiesen'

IP-Adresse bearbeiten: Asset auswählen und Status auf 'Zugewiesen' setzen.
Speichern. Die Liste zeigt die Adresse nun als Zugewiesen samt verknüpftem Asset.

An einer bestehenden Adresse setzt du beide Felder per PUT auf /api/v1/network/ips/{id}. Es werden nur die gesendeten Felder überschrieben.

curl -X PUT https://demo.notory.io/api/v1/network/ips/0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a80 \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "assigned_asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
    "status": "assigned"
  }'

{
  "id": "0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a80",
  "address": "10.0.0.10",
  "status": "assigned",
  "assigned_asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "updated_at": "2026-07-08T09:45:00Z"
}

Beim Neuanlegen kannst du assigned_asset_id und status direkt im POST /api/v1/network/ips mitgeben.

Mögliche Fehler: 401, 403 (kein Schreibrecht), 404 (IP nicht gefunden), 422 (ungültiger status).

Was passiert dabei?

Zwei getrennte Felder: Notory koppelt Asset-Zuordnung und Status nicht automatisch. Das Setzen von Zugewiesenes Asset ändert den Status nicht von selbst. Setze Zugewiesen bewusst mit, damit die Adresse in Auswertungen und bei der Suche nach freien IPs korrekt als belegt gilt.
Audit-Trail: Die Änderung vermerkt dich als letzten Bearbeiter (updated_by) samt Zeitstempel.
Stabile Verknüpfung: Wird das Asset später gelöscht, setzt Notory assigned_asset_id auf null (SET NULL). Der Status bleibt dabei unverändert. Du solltest die Adresse anschließend wieder auf Verfügbar setzen.