Alle Replication-DNS-Zonen auflisten¶

Note

Die Replication-DNS-Zonen stehen ausschließlich Organisationen zur Verfügung, für die die Funktion DNSZones freigeschaltet ist.

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.

Beschreibung¶

Mit der List-Replication-DNS-Zones-Anfrage rufen Sie eine Liste aller Replication-DNS-Zonen der Organisation ab.

Eine Replication-DNS-Zone ist eine DNS-Zone, deren Inhalt Myra von einem Master-Nameserver der Organisation überträgt. Die Zone wird nicht in der Myra App gepflegt, sondern auf dem Master-Nameserver.

Voraussetzungen¶

Werte der Anfrage: keine

Objekte: keine

Anfrage¶

Um eine Liste aller Replication-DNS-Zonen abzurufen, sind keine weiteren Informationen im Pfad der Anfrage erforderlich.

Als Ergebnis erhalten Sie ein oder mehrere Objekte 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)`

Mit der List-Replication-DNS-Zones-Anfrage filtern Sie die Ausgabe, indem Sie dem Pfad der Anfrage die folgenden Parameter hinzufügen:

Parameter	Beschreibung	Werte
`search`	Filtert die Ergebnisse nach einem Wert.	eine Zeichenkette
`replicationMethod`	Filtert die Ergebnisse nach dem Übertragungsverfahren.	`AXFR` `IXFR` `IXFR_UDP`
`sort`	Sortiert die Ergebnisse nach einem Attribut.	eine Zeichenkette
`page`	Legt die Seite der Ergebnisliste fest.	`integer`
`pageSize`	Legt die Anzahl der Einträge pro Seite fest. Der Wert `-1` gibt alle Einträge in einer Antwort zurück.	`integer`

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.