DNS-Record aktualisieren

PATCH /dns/rr/{rrid}

Bezeichner: PatchRecordByRRID

Aktualisiert einen bestimmten Resource Record (rrid). Nützlich, um Name oder Typ eines Records zu ändern oder um mehrere Records mit derselben Kombination aus Name und Typ zu verwalten.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
`rrid`	rrid	ja	-

Request Body

recordRequest

Feld	Typ	Pflicht	Beschreibung
`type`	type	nein	-
`name`	fqdn_or_subdomain	nein	Fully Qualified Domain Name (FQDN) oder Subdomain. Das Zeichen `@` steht dabei für die Apex-Domain (z. B. example.com). Wildcards werden unterstützt.
`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 aktualisierte Record
`400`	`Error`	Ungültige Anfrage
`401`	`Error`	Nicht autorisiert
`404`	`Error`	DNS-Record nicht gefunden
`417`	`Error`	Die Aktualisierung des DNS-Records verletzt eine Beschränkung der Zone
`429`	`Error`	Rate-Limit für ACME-Plattform-Zugänge (Scope `acme-dns-challenge`): Aufrufe pro Minute sowie verschiedene Kunden pro Tag. Gewöhnliche Kundenschlüssel erhalten diesen Status auf diesem Endpunkt nie.
`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/<rrid>" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "www",
    "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.