DNS-Record aktualisieren

PATCH /dns/rr

Bezeichner: PatchRecord

Aktualisiert einen DNS-Record und ermittelt ihn automatisch anhand der Parameter name und type. Sollen name oder type selbst geändert werden, ist der Endpunkt PATCH /dns/rr/{rrid} zu verwenden.

Request Body

recordRequestFQDN

Feld	Typ	Pflicht	Beschreibung
`name`	fqdn	ja	Fully Qualified Domain Name (FQDN, mit abschließendem Punkt).
`type`	type	nein	-
`ttl`	ttl	nein	Time To Live in Sekunden (60-86400)
`annotation`	`string`	nein	Freie Notiz zu diesem Record.

Dazu die Felder einer der folgenden Varianten:

Variante	Felder
`A`	`data`: ipv4
`AAAA`	`data`: ipv6
`CNAME`	`data`: fqdn
`CAA`	`flags`: `integer`, `tag`: `string`, `data`: `string`
`ALIAS`	`data`: fqdn
`MX`	`data`: fqdn, `priority`: `integer`
`TXT`	`data`: `string`

Antworten

Status	Typ	Beschreibung
`200`	`recordResponse`	Der Record zur angegebenen Kombination aus `name`/`type`
`400`	`Error`	Ungültige Anfrage
`401`	`Error`	Nicht autorisiert
`404`	`Error`	Kein Record zur angegebenen Kombination aus `name`/`type` gefunden
`417`	`Error`	Die Aktualisierung des DNS-Records verletzt eine Beschränkung der Zone
`500`	`Error`	Unerwarteter Fehler

Antwortkörper

Feld	Typ	Pflicht	Beschreibung
`success`	`boolean`	ja	Erfolgskennzeichen
`code`	`integer`	nein	Antwort-/Fehlercode
`response`	recordResponse	nein	-

Beispiel

curl -X PATCH "https://api.regfish.com/dns/rr" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "www",
    "type": "A",
    "ttl": 600,
    "annotation": "string",
    "data": "12.12.12.12"
  }'

Anfrage zusammenstellen

Werte eintragen - der Aufruf unten passt sich an. Es wird nichts abgeschickt: die API gibt Browser-Anfragen von dieser Domain aus derzeit nicht frei (CORS). Der API-Key wird nicht gespeichert.