Eine Replication-DNS-Zone ändern¶

Note

Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.

Note

Der Name der Zone kann nachträglich nicht geändert werden. Das System übernimmt das Attribut zoneName ausschließlich beim Erstellen der Zone.

Note

Wenn Sie das Attribut tsigKeyName leeren, entfernt das System auch das Verfahren und den TSIG-Schlüssel der Zone.

Senden einer PUT-Anfrage an den Endpunkt /replication-dns/zones/{id}.

Beschreibung¶

Mit der Change-Replication-DNS-Zone-Anfrage ändern Sie eine Replication-DNS-Zone der Organisation.

Voraussetzungen¶

Werte der Anfrage: Zone-ID {id}

Objekte: ReplicationDnsZoneVO

Anfrage¶

Um eine Replication-DNS-Zone zu ändern, fügen Sie die Zone-ID {id} dem Pfad der Anfrage hinzu.

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

Attribut	Beschreibung	Werte
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`
`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. Senden Sie das Attribut, um den bestehenden Schlüssel zu ersetzen.	`string`

Das System antwortet mit dem Objekt ReplicationDnsZoneVO mit den geänderten Informationen.

Beispiel¶

Beispiel-Request-Body:

{
  "id": 0,
  "modified": "string",
  "replicationMethod": "string",
  "masters": [
    "string"
  ],
  "tsigKeyName": "string",
  "tsigKeyAlgorithm": "string",
  "tsigKey": "string"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
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.