Skip to Content
Uptimeify Docs

DNS Monitor erstellen

Erstellt einen neuen DNS-Monitor für einen Kunden.

POST /api/dns-monitors

Anfrage (Request Body)

{
  "customerId": "6bfec6f6-245a-47ce-843b-157d97d56f88",
  "name": "Example DNS",
  "hostname": "deinkunde.com",
  "status": "active",
  "checkInterval": 30,
  "timeoutSeconds": 30,
  "allowedCheckCountryCodes": ["DE", "FR"],
  "dnsConfig": {
    "rrtypes": ["A", "AAAA"],
    "matchMode": "exact",
    "expectedValues": {
      "A": ["93.184.216.34"],
      "AAAA": ["2606:2800:220:1:248:1893:25c8:1946"]
    },
    "triggerOn": {
      "resolveError": true,
      "mismatch": true
    }
  }
}

Hinweise:

  • customerId, name, hostname, dnsConfig.rrtypes, dnsConfig.matchMode und dnsConfig.expectedValues sind erforderlich.
  • customerId akzeptiert entweder die interne numerische ID oder die publicId-UUID des Kunden.
  • Global Supporter dürfen keine DNS-Monitore erstellen. Ein Readonly- oder kundengebundener Zugang darf innerhalb seines eigenen Kundenbereichs einen anlegen; der Monitor wird dann auf self_service gezwungen und mit selfServiceNotAllowed oder selfServiceQuotaReached abgelehnt, wenn das Paket es nicht erlaubt oder das Kontingent erschöpft ist.
  • hostname muss ein Hostname sein (kein Protokoll, kein Pfad).
  • dnsConfig.expectedValues muss für jeden RR-Type aus dnsConfig.rrtypes mindestens einen erwarteten Wert enthalten.
  • allowedCheckCountryCodes (string[], optional)
    • Beschränkt die Checks auf diese ISO-3166-1-alpha-2-Ländercodes.
    • Jeder Eintrag muss aus genau zwei Buchstaben bestehen; die Einträge werden vor dem Speichern getrimmt, in Grossbuchstaben gewandelt und dedupliziert.
    • Ohne den Schlüssel, mit null oder mit leerem Array fällt die Einschränkung des Monitors weg; eine Einschränkung am Kunden selbst gilt weiter.
    • Die Zweibuchstaben-Regel prüft nur die Form: ein Ländercode ohne aktiven Prüfstandort wird angenommen, und der Monitor läuft danach nie eine Prüfung.

Duplikate

Hat dieser Kunde schon einen Monitor mit derselbe hostname (Gross- und Kleinschreibung und ein Punkt am Ende zählen nicht) und dieselben Record-Typen in dnsConfig.rrtypes, wird die Anfrage mit 409 und data.code monitorAlreadyExists abgewiesen. data.existingId und data.existingPublicId nennen den vorhandenen Monitor. Mit "allowDuplicate": true wird der zweite Monitor trotzdem angelegt (zum Beispiel mit anderem Intervall oder anderen Alarmwegen).

  • allowDuplicate (boolean, optional, Standard false): Monitor auch als Duplikat anlegen. Wird nicht gespeichert.
{
  "statusCode": 409,
  "statusMessage": "A monitor for this target already exists for this customer. Send allowDuplicate: true to create it anyway.",
  "data": { "code": "monitorAlreadyExists", "existingId": 300, "existingPublicId": "44444444-4444-4444-8444-444444444444" }
}

Grenze je Ziel-Host

Eine Organisation kann höchstens 100 Monitore auf denselben Ziel-Host haben, gezählt über alle Monitortypen zusammen (Websites mit HTTP, Keyword, DNS-Website und Playwright mit echter URL, dazu TCP, ICMP, DNS, SSH, SMTP, FTP und IMAP/POP). Die Grenze schützt davor, dass die Checkflotte als Lastgenerator gegen fremde Hosts missbraucht wird. Verglichen wird der exakte Hostname: Gross- und Kleinschreibung, Port, Pfad und ein Punkt am Ende zählen nicht, www.example.com und example.com sind aber verschiedene Hosts. Ist die Grenze erreicht, wird die Anfrage mit 403 und data.code targetHostMonitorLimitReached abgewiesen. data.host nennt den normalisierten Host, data.limit die Grenze. "allowDuplicate": true hebt die Grenze nicht auf. Dieselbe Prüfung läuft, wenn ein PATCH den hostname ändert. Ein PATCH ohne Hostwechsel geht immer, vorhandene Monitore über der Grenze bleiben bestehen. Brauchst du eine höhere Grenze, wende dich an den Support. Unabhängig von deiner Organisation dürfen über alle Uptimeify-Kunden hinweg höchstens 300 Monitore auf denselben Host zeigen. Darüber wird die Anfrage mit 403 und data.code targetHostPlatformLimitReached abgewiesen; data.host und data.limit sind wie oben gesetzt, die Meldung verrät nicht, wie viele Monitore andere Organisationen haben.

{
  "statusCode": 403,
  "statusMessage": "Target host monitor limit reached: your organization already has 100 monitors for example.com (maximum 100 per host). Remove monitors for this host or contact support to raise the limit.",
  "data": { "code": "targetHostMonitorLimitReached", "host": "example.com", "limit": 100 }
}

Beispiel (cURL)

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

curl -X POST \
  "$BASE_URL/api/dns-monitors" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"6bfec6f6-245a-47ce-843b-157d97d56f88","name":"Example DNS","hostname":"deinkunde.com","allowedCheckCountryCodes":["DE","FR"],"dnsConfig":{"rrtypes":["A"],"matchMode":"exact","expectedValues":{"A":["93.184.216.34"]},"triggerOn":{"resolveError":true,"mismatch":true}}}'

Häufige Fehler

  • 400 Invalid Customer identifier
  • 400 hostname must be a valid hostname (no protocol, no path)
  • 400 Expected values are required for RR type <TYPE>
  • 400 Bad Request, wenn ein Eintrag in allowedCheckCountryCodes kein zweibuchstabiger Ländercode ist; die zod-Meldungen stehen in data
  • 401 Unauthorized
  • 403 Forbidden (Global Supporter, ein Kunde ausserhalb des eigenen Bereichs, selfServiceNotAllowed oder selfServiceQuotaReached)
  • 404 Customer not found
  • 403 targetHostMonitorLimitReached: die Organisation hat schon 100 Monitore auf diesen Ziel-Host (siehe Grenze je Ziel-Host); allowDuplicate: true hebt die Grenze nicht auf
  • 403 targetHostPlatformLimitReached: auf den Host zeigen über alle Uptimeify-Kunden schon 300 Monitore (siehe Grenze je Ziel-Host)
  • 409 monitorAlreadyExists: dieser Kunde hat schon so einen Monitor (siehe Duplikate); allowDuplicate: true legt ihn trotzdem an

Antwort (Response)

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

Auf dieser Seite