Skip to main content
PUT
Master-Adressen einer Slave-Zone ändern

Authorizations

Authorization
string
header
required

Access-Token aus POST /auth/login (E-Mail und Passwort), gesendet als Authorization: Bearer <token>.

Das Token ist zeitlich begrenzt gültig. Mit dem refresh_token aus derselben Antwort holt POST /auth/token/refresh ein neues Token-Paar, ohne das Passwort erneut zu senden; POST /auth/token/invalidate macht den Refresh-Token beim Abmelden ungültig.

Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert der Login statt des Token-Paars mfaRequired: true bzw. mfaEnrollmentRequired: true und ein kurzlebiges preAuthToken. Mit diesem Token (ebenfalls als Bearer) wird der zweite Faktor über POST /auth/2fa/verify bestätigt; erst danach gibt es das volle Token-Paar.

Headers

X-Customer-Id
string

Optionaler Kundenkontext. Ohne Header arbeitet die Anfrage im Standard-Kunden des angemeldeten Benutzers. Mit der ID eines anderen Kunden handelt die Anfrage in dessen Kontext: Listen, Lese- und Schreibzugriffe beziehen sich dann auf diesen Kunden.

Erlaubt sind der eigene Kunde, jeder Unterkunde im eigenen Teilbaum (Reseller handelt für seinen Endkunden) sowie Kunden, in denen der Benutzer selbst Mitglied ist. Übergeordnete oder fremde Kunden werden mit 403 Forbidden abgewiesen, eine unbekannte ID ebenfalls.

Die IDs der erreichbaren Kunden liefern GET /user/customers und GET /customers/{id}/children.

Example:

"01JD4Q8W3N6Y2K5T7R9V0B1C2D"

Path Parameters

id
string
required

Zone identifier

Body

application/json

The updated Zone resource

masterIpAddresses
string[]

Neue Master-Adressen (1 bis 5, öffentliche IPv4/IPv6 ohne Port).

Example:
tsigKey
object | null

Neuen TSIG-Schlüssel setzen (ersetzt einen vorhandenen). Weglassen = unverändert.

removeTsigKey
boolean
default:false

true entfernt den TSIG-Schlüssel.

Response

Zone resource updated

zoneId
string
default:""
Example:

"A1B2C3D4E5F6G7H8I9J0"

zone
string
default:""
Example:

"example.com"

masterIpAddresses
string[]

IP-Adressen des Master-Nameservers des Kunden.

Example:
tsigAlgorithm
string | null

Algorithmus des TSIG-Schlüssels, null ohne TSIG.

Example:

"hmac-sha256"

state
enum<string>
default:unknown

pending: Transfer steht aus. ok: übertragen und aktuell. stale: Master länger nicht erreichbar. failed: noch nie übertragen. unknown: Status nicht abrufbar.

Available options:
pending,
ok,
stale,
failed,
unknown
Example:

"ok"

stateMessage
string
default:""

Erklärung des Zustands für den Kunden (deutsch).

serial
integer | null

SOA-Serial des übertragenen Stands, null = noch nie übertragen.

Example:

2026112101

lastCheckAt
string | null

Letzte erfolgreiche Prüfung beim Master (ISO 8601).

Example:

"2026-11-21T10:00:00+00:00"

lastTransferAt
string | null

Zeitpunkt, zu dem zuletzt ein neuer Stand übertragen wurde (ISO 8601).

Example:

"2026-11-21T09:00:00+00:00"

retrieveRequestedAt
string | null

Letzter angestoßener Abruf (ISO 8601).

retrieveAvailableAt
string | null

Ab wann ein erneuter Abruf möglich ist (ISO 8601), null = sofort.

live
boolean
default:false

true: Status eben bei unseren Nameservern gelesen. false: letzter gespeicherter Stand.

checkedAt
string | null

Zeitpunkt des angezeigten Status (ISO 8601).

records
object[]

Übertragene Records (nur lesbar). name relativ zur Zone. SOA fehlt, die Apex-NS stehen als NS-Records darin.

notConvertible
object[]

Übertragene Einträge, die eine normale Zone bei uns nicht führen kann (z. B. DNSSEC-Signaturen). Solange es welche gibt, ist keine Umwandlung möglich.

axfrSourceIps
string[]

Von diesen Adressen holen unsere Nameserver die Zone. Dein Master muss AXFR/IXFR von dort erlauben.

Example:
notifyTargetIps
string[]

An diese Adressen schickt dein Master NOTIFY.

Example:
featureEnabled
boolean
default:false

Ist sekundäres DNS für den Kunden freigeschaltet? Ohne Freischaltung gehen nur Lesen und Löschen.

actions
object

Welche Aktionen gerade möglich sind.

Example: