---
title: "DNS Monitor aktualisieren"
description: "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)

```json
{
	"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)

```bash
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](/de/api/error-codes-and-known-pitfalls) für Fehlerantworten.
