Uptimeify Docs

DNS Monitor aktualisieren

Aktualisiert einen DNS-Monitor.

PATCH /api/dns-monitors/:dnsMonitorPublicId

Hinweise:

  • Readonly-User dürfen nur status ändern.
  • Global Supporter dürfen nicht mutieren.
  • Wenn du customerId mitsendest, akzeptiert das Feld entweder die interne numerische ID oder die publicId-UUID des Kunden.

Request Body (Beispiel)

{
	"customerId": "6764e84f-f02a-43e6-a46d-cecaec556723",
	"status": "maintenance",
	"name": "Primary DNS Monitor",
	"hostname": "claas.sh",
	"checkInterval": 30,
	"timeoutSeconds": 30,
	"dnsConfig": {
		"rrtypes": ["A"],
		"matchMode": "exact",
		"expectedValues": {
			"A": ["76.76.21.21"]
		},
		"triggerOn": {
			"resolveError": true,
			"mismatch": true
		}
	}
}

Wenn du dnsConfig mitsendest, muss es rrtypes, matchMode und für jeden RR-Type in rrtypes mindestens einen Eintrag in expectedValues enthalten.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X PATCH \
	"$BASE_URL/api/dns-monitors/11111111-1111-4111-8111-111111111111" \
	-H "Authorization: Bearer $TOKEN" \
	-H "Content-Type: application/json" \
	-d '{"customerId":"6764e84f-f02a-43e6-a46d-cecaec556723","status":"maintenance","name":"Primary DNS Monitor","hostname":"claas.sh","checkInterval":30,"timeoutSeconds":30,"dnsConfig":{"rrtypes":["A"],"matchMode":"exact","expectedValues":{"A":["76.76.21.21"]},"triggerOn":{"resolveError":true,"mismatch":true}}}'

Häufige Fehler

  • 400 DNS monitor ID is required
  • 400 Invalid status
  • 400 Invalid Customer identifier
  • 400 Expected values are required for RR type <TYPE>
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Customer not found

Antwort (Response)

Gibt das aktualisierte DNS-Monitor-Objekt zurück. Siehe Fehlerliste für Fehlerantworten.

Auf dieser Seite