DNS-Einträge

Zuletzt aktualisiert am 8. Okt. 2026

Alle DNS-Ressourceneinträge abrufen

Listet alle Einträge einer bestimmten DNS-Zone auf. Gibt alle Einträge einschließlich ihres Sperrstatus zurück.

URL: GET /api/v1/organizations/{orgId}/dns-zones/{dnsZoneId}/dns-resource-records

Beispielantwort (200 OK):

[
  {
    "dnsResourceRecordId": "f7dfd377-cb4a-4417-8458-0a221ae3b835",
    "name": "www",
    "recordType": "A",
    "recordData": "194.175.123.125",
    "timeToLive": 3600,
    "isLockedByUser": false,
    "isLockedByProvider": false
  }
]

DNS-Ressourceneintrag hinzufügen

Erstellt einen neuen Eintrag in einer primären Zone.

URL: POST /api/v1/organizations/{orgId}/dns-zones/{dnsZoneId}/dns-resource-records

Anfrage-Body:

{
  "name": "blog",
  "recordClass": "IN",
  "recordType": "A",
  "recordData": "1.2.3.4",
  "timeToLive": 3600
}

DNS-Ressourceneintrag aktualisieren

Aktualisiert gezielt die Werte eines bestehenden Eintrags (z. B. die IP-Adresse oder die TTL), ohne ihn löschen und neu erstellen zu müssen. Ideal für DynDNS-Szenarien oder schnelle IP-Änderungen. URL: PATCH /api/v1/organizations/{orgId}/dns-zones/{dnsZoneId}/dns-resource-records/{recordId}

Anfrage-Body:

{
  "name": "www",
  "recordClass": "IN",
  "timeToLive": 3600,
  "recordType": "AAAA",
  "recordData": "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
}

Eintrag sperren / entsperren

Diese Funktion verhindert, dass kritische Einträge (z. B. Ihr Haupt-Webserver) versehentlich durch Skripte geändert oder gelöscht werden.

Sperr-URL: PATCH .../dns-resource-records/{recordId}/lock
Entsperr-URL: PATCH .../dns-resource-records/{recordId}/unlock

Anfrage-Body (Sperren):

{
  "reason": "Central Production-Server. Changes after Change-Request!"
}

Alle Einträge ersetzen

Ersetzt die gesamte Liste der Einträge in einer Zone. Dies ist ideal für automatisierte Bereitstellungen (CI/CD), um einen definierten Zielzustand herzustellen.

URL: PUT /api/v1/organizations/{orgId}/dns-zones/{dnsZoneId}/dns-resource-records

Anfrage-Body:

{
  "dnsResourceRecords": [
    {
      "name": "@",
      "recordType": "A",
      "recordData": "1.1.1.1",
      "timeToLive": 3600,
      "recordClass": "IN"
    },
    {
      "name": "mail",
      "recordType": "MX",
      "recordData": "10 mail.provider.de",
      "timeToLive": 3600,
      "recordClass": "IN"
    }
  ]
}

DNS-Ressourceneintrag löschen

Löscht einen bestimmten Eintrag unter Verwendung seiner ID.

URL: DELETE /api/v1/organizations/{orgId}/dns-zones/{dnsZoneId}/dns-resource-records/{recordId}

Antwort (Erfolgreich gelöscht):

204 No Content

Alle DNS-Resource-Records löschen

Ein “Full Cleanup”-Befehl. Löscht alle Resource Records innerhalb einer Zone.

URL: DELETE /api/v1/organizations/{orgId}/dns-zones/{dnsZoneId}/dns-resource-records

Antwort (Erfolgreich gelöscht):

204 No Content