DNS Monitor erstellen

POST /api/dns-monitors

Anfrage (Request Body)Ankerlink kopieren

{
  "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.

Beispiel (cURL)Ankerlink kopieren

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 FehlerAnkerlink kopieren

• 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

Antwort (Response)Ankerlink kopieren

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