Einen DNS-Eintrag ändern¶

Note

Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.

Note

Stellen Sie sicher, dass die ID des DNS-Eintrags im Pfad der Anfrage mit dem Wert des Attributs id im Body übereinstimmt.

Note

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

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

Beschreibung¶

Mit der Change-DNS-Record-Anfrage ändern Sie einen DNS-Eintrag einer Domain der Organisation.

Voraussetzungen¶

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

Objekte: DnsRecordVO

Anfrage¶

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

Für eine detaillierte Spezifikation, welche Informationen zum Ändern eines DNS-Eintrags erforderlich sind, muss im Body das Objekt 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`
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`

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 das Objekt DnsRecordVO mit den geänderten Informationen 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
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.