Wie strukturiere ich Rechenzentren und Racks?

Ab Tarif Pro

Kurzantwort

Notory bildet die physische Struktur in drei Ebenen ab: Standort → Rechenzentrum → Rack. Lege im Modul Infrastruktur zuerst ein Rechenzentrum an und weise es einem Standort zu; danach legst du Racks an und weist sie dem Rechenzentrum zu. Racks können optional zu Rackgruppen gebündelt und mit Höheneinheiten (HE) versehen werden. Einen eigenen Objekttyp „Raum” gibt es nicht. Der Serverraum ist das Rechenzentrum.

Voraussetzungen

Das Modul Infrastruktur ist ab Tarif Pro verfügbar (Feature Multi-Tenant). Ein Standort sollte bereits existieren.

Rechenzentrum anlegen. Wechsle im Modul Infrastruktur auf den Reiter Rechenzentren und klicke auf Hinzufügen. Vergib einen Namen (z. B. „RZ-1 / Serverraum EG”) und wähle den zugehörigen Standort.

Screenshot ausstehend infrastruktur-racks-01 Reiter 'Rechenzentren' im Modul Infrastruktur mit dem Formular für ein neues Rechenzentrum

Reiter 'Rechenzentren': das Rechenzentrum einem Standort zuordnen.
Rack anlegen. Wechsle auf den Reiter Racks und klicke auf Hinzufügen.
- Name: z. B. „Rack A01”
- Rechenzentrum: Auswahl des zuvor angelegten Rechenzentrums
- Rackgruppe (optional): zum Bündeln mehrerer Racks
- Rolle (optional): z. B. „Netzwerk” oder „Storage”
- Höheneinheiten (HE) (optional): Bauhöhe, 1 bis 60
- Beschreibung (optional)
Screenshot ausstehend infrastruktur-racks-02 Formular 'Rack' mit Feldern Name, Rechenzentrum, Rackgruppe, Rolle, Höheneinheiten

Das Rack-Formular: Zuordnung zu Rechenzentrum und optionaler Rackgruppe.
Speichern. Racks erscheinen in der Liste. Anschließend kannst du Assets verorten.

Zuerst das Rechenzentrum (POST /api/v1/infrastructure/datacenters), mit Bezug auf den Standort:

curl -X POST https://demo.notory.io/api/v1/infrastructure/datacenters \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "RZ-1 / Serverraum EG",
    "location_id": "0190f3b0-1a10-7c20-9d30-4e50f60a7b80"
  }'

Dann das Rack (POST /api/v1/infrastructure/racks), mit Bezug auf das Rechenzentrum:

curl -X POST https://demo.notory.io/api/v1/infrastructure/racks \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rack A01",
    "datacenter_id": "0190f3b0-2b20-7d30-ae40-5f60a70b8c90",
    "role": "Netzwerk",
    "height_units": 42
  }'

{
  "id": "0190f3b0-3c30-7e40-bf50-6a70b80c9d01",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "name": "Rack A01",
  "datacenter_id": "0190f3b0-2b20-7d30-ae40-5f60a70b8c90",
  "group_id": null,
  "role": "Netzwerk",
  "height_units": 42,
  "description": null,
  "created_at": "2026-07-08T10:10:00Z",
  "updated_at": "2026-07-08T10:10:00Z"
}

Mögliche Fehler: 401, 403 (Rechte/Rolle oder Modul nicht im Tarif), 422 (Validierung: z. B. height_units außerhalb 1 bis 60 oder leerer name).

Was passiert dabei?

Lockere Verkettung: Die Ebenen sind über optionale Verweise verbunden (Datacenter.location_id, Rack.datacenter_id). Beim Löschen einer übergeordneten Ebene setzt Notory den Verweis auf null (SET NULL). Untergeordnete Objekte bleiben erhalten, verlieren aber ihre Zuordnung.
Höheneinheiten: height_units ist auf 1 bis 60 begrenzt und dient der Dokumentation der Bauhöhe; Notory berechnet daraus keine automatische Belegung.
Gruppen sind optional: Rackgruppen bündeln Racks organisatorisch (z. B. je Reihe) und sind unabhängig von der Rechenzentrums-Zuordnung.
Mandanten-Isolation & Gating: Alle Objekte gehören deinem Mandanten; ohne das Feature Multi-Tenant (Tarif Pro) antwortet die API mit 403.