Die Bind-Konfiguration einer Domain abrufen¶

Senden einer GET-Anfrage an den Endpunkt /domains/{id}/bind/{ipTarget}.

Beschreibung¶

Mit der Get-Bind-Configuration-Anfrage rufen Sie die Bind-Konfiguration eines Servers der Organisation ab.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {id}, IP-Target-Name {ipTarget}

Objekte: DomainBindVO

Anfrage¶

Um die Bind-Konfiguration einer Domain abzurufen, fügen Sie die Domain-ID {id} und den IP-Target-Name {ipTarget} dem Pfad der Anfrage hinzu.

Der Wert für IP-Target-Name hängt vom Endpunkt ab, den Sie anfragen möchten.

Verwenden Sie Myra für Myra als Endpunkt oder Origin für die Kundeninfrastruktur als Endpunkt.

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

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`domainname`	Der Name der Domain.	`string`
`ttl`	Die Time to Live in Sekunden.	`300` -> 5 Minuten `600` -> 10 Minuten `900` -> 15 Minuten `1800` -> 30 Minuten `3600` -> 1 Stunde `7200` -> 2 Stunden `18000` -> 5 Stunden `43200` -> 12 Stunden `86400` -> 1 Tag
`primaryDns`	Der Nameserver der Domain.	`string`
`hostmaster`	Der Host des Nameservers.	`string`
`timeToRefresh`		`integer`
`timeToRetry`		`integer`
`ptimeToExpire`	Die Gültigkeit der Konfiguration in Sekunden.	`integer`
`minimumTTL`	Der Mindestwert für die TTL.	`integer`
`version`	Die Version der Konfiguration.	`integer`
`domain (records)`	Der Name der Subdomain.	`string`
`ttl (records)`	Die Time to Live in Sekunden für die DNS-Einträge.	`integer`
`type (records)`	Der Wert zur Identifizierung des Typs eines DNS-Eintrags.	`A` `AAAA` `MX` `CNAME` `TXT` DS: der Delegation Signer `NS` `SRV`
`value (records)`	Die Werte im Format einer IP-Adresse, eines Namens oder eines Texts für den DNS-Eintrag.	A-Record: IPv4-Adresse AAAA-Record: IPv6-Adresse CNAME: ein Domainname MX: ein Domainname (ohne IP) NS: IP-Adresse SRV: ein Domainname TXT: ein beliebiger Text. DS: der Delegation Signer
`cnameAI (records)`	Der alternative CNAME, der auf den DNS-Eintrag verweist.
`rtype (records)`	Der Eintrag ist ein Nameserver (dns) oder ein normaler Record.
`active (records)`	Die Verfügbarkeit des Eintrags.	`true` `false`

Beispiel¶

Beispiel-Antwort:

{
  "domainname": "string",
  "ttl": "300",
  "primaryDns": "string",
  "hostmaster": "string",
  "timeToRefresh": 0,
  "timeToRetry": 0,
  "ptimeToExpire": 0,
  "minimumTTL": 0,
  "version": 0,
  "domain (records)": "string",
  "ttl (records)": 0,
  "type (records)": "A",
  "value (records)": "string",
  "cnameAI (records)": "string",
  "rtype (records)": "string",
  "active (records)": true
}

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.