Eine Replication-DNS-Zone abrufen¶

Note

Das Attribut tsigKey wird nie zurückgegeben. Das System nimmt den Schlüssel entgegen, liefert ihn aber nicht aus.

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

Beschreibung¶

Mit der Get-Replication-DNS-Zone-Anfrage rufen Sie eine einzelne Replication-DNS-Zone der Organisation ab.

Voraussetzungen¶

Werte der Anfrage: Zone-ID {id}

Objekte: keine

Anfrage¶

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

Als Ergebnis erhalten Sie ein Objekt ReplicationDnsZoneVO mit den angefragten Informationen.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`zoneName`	Der Name der Zone als vollqualifizierter Domainname.	`string`
`label`	Die Bezeichnung des Eintrags. Sie entspricht dem Wert des Attributs `zoneName`.	`string`
`replicationMethod`	Das Verfahren, mit dem Myra die Zone vom Master-Nameserver überträgt.	`AXFR` `IXFR` `IXFR_UDP`
`masters`	Ein Array mit den IP-Adressen der Master-Nameserver, von denen Myra die Zone überträgt.	array
`tsigKeyName`	Der Name des TSIG-Schlüssels, mit dem der Zonentransfer abgesichert wird.	`string`
`tsigKeyAlgorithm`	Das Verfahren des TSIG-Schlüssels.	`hmac-md5` `hmac-sha1` `hmac-sha224` `hmac-sha256` `hmac-sha384` `hmac-sha512`
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`
`created`	Das Erstellungsdatum im ISO-8601-Format.	`string($date-time)`

Beispiel¶

Beispiel-Antwort:

{
  "objectType": "string",
  "zoneName": "string",
  "label": "string",
  "replicationMethod": "string",
  "masters": [
    "string"
  ],
  "tsigKeyName": "string",
  "tsigKeyAlgorithm": "string",
  "id": 0,
  "modified": "string",
  "created": "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.