Einen DNS-Eintrag abrufen¶

Note

Um einen DNS-Eintrag abzurufen, muss bereits eine Domain erstellt sein.

Senden einer GET-Anfrage an den Endpunkt /domain/{domainId}/dns-records/{id}.

Beschreibung¶

Mit der List-DNS-Record-Anfrage rufen Sie einen DNS-Eintrag einer Domain der Organisation ab.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, DNS-Record-ID {id}

Objekte: keine

Anfrage¶

Um einen DNS-Eintrag einer Domain abzurufen, fügen Sie die Domain-ID {domainId} und die DNS-Record-ID {id} dem Pfad der Anfrage hinzu.

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

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`name`	Der Name der Subdomain des DNS-Eintrags. Entspricht in der Regel dem Namen der Domain oder Subdomain, für die der DNS-Eintrag definiert ist.	`string`
`value`	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
`priority`	Die Priorität eines MX-Records.	`integer`
`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
`vhostId`	Die ID der Subdomain, der der DNS-Eintrag zugeordnet ist.	`integer`
`recordType`	Der Wert zur Identifizierung des Typs eines DNS-Eintrags.	`A` `AAAA` `MX` `CNAME` `TXT` DS: der Delegation Signer `NS` `SRV`
`weight`	Die Gewichtung des SRV-Records.	`integer`
`port`	Der Server-Port des SRV-Records.	`integer`
`active`	Legt fest, ob die Domain oder Subdomain durch Myra geschützt werden soll oder nicht.	`true` `false`
`sslCertTemplate`		`Null` `string`
`upstreamOptions`	Ein Array mit einem oder mehreren Objekten `UpstreamOptionsVO` mit Informationen zu den Load-Balancing-Einstellungen.	`UpstreamOptionsVO`
`alternativeCname`	Der alternative CNAME, der auf den DNS-Eintrag verweist.	`string`
`caaFlags`	Der Standardwert ist 0. Wird er auf 1 gesetzt, wird die Validierung blockiert, wenn das Tag der CA unbekannt ist.	`integer`
`caaTag`	Zeigt eine der folgenden Optionen: `issue`: Die CA ist berechtigt, ein Zertifikat für die Domain auszustellen `issuewild`: Die CA darf Wildcard-Zertifikate für die Domain ausstellen `iodef`: Die URL, über die die CA eine Fehlermeldung im Incident Object Description Exchange Format senden kann.	`string`
`endpoints`	Die öffentliche Myra-IPv4- und -IPv6-Adresse für den DNS-Eintrag.	array
`serviceType`	Der Typ des Dienstes hinter dem DNS-Eintrag.	`1` -> HTTP `2` -> MAIL `3` -> OTHER
`enabled`	Die Verfügbarkeit des Eintrags.	`true` `false`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`
`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",
  "name": "string",
  "value": "string",
  "priority": 0,
  "ttl": 0,
  "vhostId": 0,
  "recordType": "string",
  "weight": 0,
  "port": 0,
  "active": true,
  "paused": true,
  "sslCertTemplate": "string",
  "upstreamOptions": "string",
  "alternativeCname": "string",
  "environment": "string",
  "caaFlags": 0,
  "caaTag": "string",
  "endpoints": "string",
  "serviceType": 0,
  "encryption": "string",
  "identificationNumber": "string",
  "hashType": "string",
  "id": 0,
  "modified": "string",
  "created": "string",
  "enabled": true,
  "comment": "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.