DNS-Zonen

Alle DNS-Zonen abrufen

Listet alle konfigurierten DNS-Zonen für eine Organisation auf. Zeigt sowohl primäre als auch sekundäre Zonen zusammen mit der Anzahl der darin enthaltenen Records an.

URL: GET /api/v1/organizations/{organizationId}/dns-zones

Beispielantwort (200 OK):

[
  {
    "dnsZoneId": "11ed0603-0bf3-4e1e-888a-f4bed05f4c77",
    "name": "meine-firma.de",
    "dnsZoneType": "primary",
    "recordCount": 12,
    "soaSerialNumber": "2026012801"
  }
]

Primäre DNS-Zone hinzufügen

Erstellt eine neue primäre Zone. In diesem Modus haben Sie die volle Kontrolle über alle Records.

URL: POST /api/v1/organizations/{organizationId}/dns-zones/primary

Anfrage-Body:

{
  "name": "neue-zone.cloud",
  "soaMName": "ns1.domains.stackit.cloud",
  "soaRName": "admin.neue-zone.cloud.",
  "soaRefreshInterval": 86400,
  "soaRetryInterval": 7200,
  "soaExpire": 3600000,
  "soaMinTtl": 180
}

Sekundäre DNS-Zone hinzufügen

Erstellt eine sekundäre Zone. STACKIT fungiert hier als Sekundärserver und spiegelt die Daten Ihres eigenen primären Nameservers.

URL: POST /api/v1/organizations/{organizationId}/dns-zones/secondary

Anfrage-Body:

{
  "name": "slave-zone.de",
  "primaryNameServerIpAddress": "1.2.3.4"
}

DNS-Zone aktualisieren

Aktualisiert die SOA-Einstellungen (Start of Authority) oder die IP des primären Nameservers.

URL: PATCH /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}

Anfrage-Body (SOA Update):

{
  "soaRName": "hostmaster.stackit.cloud.",
  "soaMName": "ns1.domains.stackit.cloud.",
  "soaRefreshInterval": 86400,
  "soaRetryInterval": 7200,
  "soaExpire": 3600000,
  "soaMinTtl": 180,
  "primaryNameserverIpAddress": "194.175.123.125"
}

DNS-Zone löschen

Entfernt eine Zone unwiderruflich aus dem System. Hinweis: Dieser Befehl löscht auch alle enthaltenen Resource Records, Web-Weiterleitungen und E-Mail-Weiterleitungen.

URL: DELETE /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}

Antwort (Erfolgreich gelöscht):

204 No Content