Eine Replication-DNS-Zone hinzufügen¶

Note

Der Name der Zone muss innerhalb von Myra eindeutig sein und darf keiner Domain entsprechen, die bereits über das CDN geschützt wird.

Note

Der Body enthält die Attribute id, created und modified nicht. Die Werte dieser Attribute werden vom System nach dem Erstellen des Eintrags gesetzt.

Note

Der Name der Zone kann nachträglich nicht geändert werden.

Senden einer POST-Anfrage an den Endpunkt /replication-dns/zones.

Beschreibung¶

Mit der Add-Replication-DNS-Zone-Anfrage fügen Sie eine Replication-DNS-Zone für die Organisation hinzu. Myra überträgt anschließend den Inhalt der Zone von den angegebenen Master-Nameservern.

Voraussetzungen¶

Werte der Anfrage: keine

Objekte: ReplicationDnsZoneVO

Anfrage¶

Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen einer Replication-DNS-Zone erforderlich sind, muss im Body das Objekt ReplicationDnsZoneVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`zoneName`	Der Name der Zone als vollqualifizierter Domainname. Erlaubt sind 1 bis 255 Zeichen.	`string`
`masters`	Ein Array mit den IP-Adressen der Master-Nameserver, von denen Myra die Zone überträgt. Mindestens eine IP-Adresse ist erforderlich. Zulässig sind IPv4- und IPv6-Adressen.	array

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`replicationMethod`	Das Verfahren, mit dem Myra die Zone vom Master-Nameserver überträgt.	Standard: `IXFR` Mögliche Werte: `AXFR` `IXFR` `IXFR_UDP`
`tsigKeyName`	Der Name des TSIG-Schlüssels, mit dem der Zonentransfer abgesichert wird.	`string`
`tsigKeyAlgorithm`	Das Verfahren des TSIG-Schlüssels. Das Attribut ist erforderlich, sobald ein TSIG-Schlüssel gesetzt ist.	`hmac-md5` `hmac-sha1` `hmac-sha224` `hmac-sha256` `hmac-sha384` `hmac-sha512`
`tsigKey`	Der TSIG-Schlüssel. Das Attribut ist erforderlich, sobald ein TSIG-Schlüssel gesetzt ist.	`string`

Das System antwortet mit dem Objekt ReplicationDnsZoneVO mit den Informationen zum neuen Eintrag.

Beispiel¶

Beispiel-Request-Body:

{
  "zoneName": "string",
  "replicationMethod": "string",
  "masters": [
    "string"
  ],
  "tsigKeyName": "string",
  "tsigKeyAlgorithm": "string",
  "tsigKey": "string"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.