Einen DNS-Eintrag für eine Domain hinzufügen¶

Note

Um einen DNS-Eintrag hinzuzufügen, muss bereits eine Domain erstellt sein.

Note

Wenn die optionalen Attribute nicht gesetzt sind, setzt das System einen Standardwert ein.

Note

Sie können die Einstellungen für Load Balancing zusammen mit der Erstellung eines DNS-Eintrags festlegen. Fügen Sie dazu lediglich das Objekt UpstreamOptionsVO unter upstreamOptions hinzu.

Note

Der Body enthält die Attribute id, created und modified nicht. Die Werte dieser Attribute werden vom System nach dem Erstellen des Eintrags gesetzt.

Note

Das Attribut sslCertTemplate ist optional und muss gesetzt werden, um ein SSL/TLS-Zertifikat zu verwenden. Wird kein SSL/TLS-Zertifikat benötigt, lassen Sie das Attribut im Body weg.

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

Beschreibung¶

Mit der Add-DNS-Record-Anfrage fügen Sie einen oder mehrere DNS-Einträge für eine Domain der Organisation hinzu.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}

Objekte: DnsRecordVO

Anfrage¶

Um DNS-Einträge für eine Domain hinzuzufügen, fügen Sie die Domain-ID {domainId} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen eines DNS-Eintrags erforderlich sind, müssen im Body ein oder mehrere Objekte DnsRecordVO mit den folgenden Attributen definiert werden:

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
`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
`recordType`	Der Wert zur Identifizierung des Typs eines DNS-Eintrags.	`A` `AAAA` `MX` `CNAME` `TXT` DS: der Delegation Signer `NS` `SRV`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`priority`	Die Priorität eines MX-Records.	`integer`
`vhostId`	Die ID der Subdomain, der der DNS-Eintrag zugeordnet ist.	`integer`
`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.	`string`
`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`

Das System gibt als Antwort das Objekt DnsRecordVO mit den Informationen zum neuen Eintrag zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "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",
  "enabled": true,
  "comment": "string"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
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.