Maintenance Window erstellen

POST /api/maintenance-windows

BodyAnkerlink kopieren

{
  "name": "Datenbank-Migration",
  "startTime": "2026-07-10T22:00:00.000Z",
  "endTime": "2026-07-11T01:00:00.000Z",
  "targets": [
    { "type": "website", "id": "ef8a6564-0ccf-4f3f-a5ef-d2963176b3eb" },
    { "type": "icmp", "id": "3d005a18-fdd8-4dc7-9f26-1a9d409c1bc5" }
  ],
  "tagIds": [7],
  "description": "Geplante Schema-Migration",
  "isRecurring": false,
  "isActive": true
}

PflichtfelderAnkerlink kopieren

• name (string): Eine freundliche Bezeichnung für das Fenster.
• startTime (ISO 8601 Datetime): Zeitpunkt, an dem das Fenster beginnt.
• endTime (ISO 8601 Datetime): Zeitpunkt, an dem das Fenster endet. Muss nach startTime liegen.
• Mindestens ein Zielfeld (siehe unten).

Zielauswahl (gegenseitig ausschließende Modi)Ankerlink kopieren

Genau ein Targeting-Modus muss verwendet werden. targets und tagIds können innerhalb des Multi-Monitor-Modus kombiniert werden.

Nur-Tag-Modus (organisationsweit)Ankerlink kopieren

Wird tagIds ohne customerId, targets oder Legacy-Felder gesendet, entsteht ein organisationsweites Wartungsfenster. Es deckt dynamisch jeden Monitor der gesamten Organisation ab, der aktuell die angegebenen Tags trägt, über alle Kunden hinweg.

{
  "name": "Infra-Tag-Freeze",
  "startTime": "2026-07-10T22:00:00.000Z",
  "endTime": "2026-07-11T01:00:00.000Z",
  "tagIds": [7]
}

• Erfordert einen organisationsweiten Admin oder Editor: die Rolle UND einen uneingeschränkten Kunden-Scope. Ein kundengebundener Akteur (ein readonly-Benutzer, ein editor mit Kundenzuweisungen, ein Customer-Scoped Token) bekommt kein organisationsweites Fenster: Ist er genau einem Kunden zugeordnet, wird das Fenster an diesen Kunden gebunden und deckt nur dessen getaggte Monitore ab; ist er mehreren (oder keinem) zugeordnet, wird der Request mit 400 tagOnlyNeedsCustomer abgelehnt und er muss stattdessen Monitore oder einen Kunden auswählen. Siehe Rollen und der Kunden-Scope.
• Die Tag-Zugehörigkeit wird live zur Prüfzeit aufgelöst: nach der Fenstererstellung getaggte Monitore werden automatisch abgedeckt.
• Alle tagIds müssen zur selben Organisation gehören; das Mischen von Tags verschiedener Organisationen gibt 400 mixedTagOrganizations zurück.

KombinationsregelnAnkerlink kopieren

• Mindestens ein Zielfeld ist erforderlich. Das Weglassen aller Felder ist ein Zod-Validierungsfehler (Standard-400 mit Validierungsantwort, kein data.code-Fehler).
• customerId (Kunden-Ebene-Modus) kann nicht mit targets, tagIds oder Legacy-Feldern kombiniert werden. Das Kombinieren ist ein Zod-Validierungsfehler (Standard-400).
• Alle Monitore in targets müssen zum selben Kunden gehören; das Mischen von Kunden gibt { data: { code: "mixedCustomers" } } zurück.
• Alle tagIds müssen zur selben Organisation gehören; das Mischen gibt { data: { code: "mixedTagOrganizations" } } zurück.

Optionale FelderAnkerlink kopieren

WiederholungAnkerlink kopieren

{
  "frequency": "weekly",
  "interval": 1,
  "daysOfWeek": [1, 3],
  "dayOfMonth": null,
  "endRecurrenceDate": "2026-12-31"
}

Dynamisches Tag-VerhaltenAnkerlink kopieren

Die Tag-Abdeckung wird vom Monitoring-Worker live zum Zeitpunkt der Prüfung aufgelöst. Ein Monitor, der nach der Fenstererstellung getaggt wird, wird automatisch abgedeckt, ohne das Fenster zu aktualisieren. Das Entfernen eines Tags von einem Monitor beendet die Abdeckung sofort.

Beispiel (cURL)Ankerlink kopieren

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

curl -X POST "$BASE_URL/api/maintenance-windows" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Datenbank-Migration",
    "startTime": "2026-07-10T22:00:00.000Z",
    "endTime": "2026-07-11T01:00:00.000Z",
    "targets": [
      { "type": "website", "id": 101 }
    ]
  }'

Antwort (Response)Ankerlink kopieren

{
  "id": 42,
  "publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "organizationId": 10,
  "customerId": 1,
  "name": "Datenbank-Migration",
  "description": null,
  "startTime": "2026-07-10T22:00:00.000Z",
  "endTime": "2026-07-11T01:00:00.000Z",
  "isRecurring": false,
  "recurrencePattern": null,
  "isActive": true,
  "timezone": "UTC",
  "targets": [
    { "type": "website", "id": 101 }
  ],
  "tags": [],
  "websiteId": null,
  "icmpMonitorId": null,
  "smtpMonitorId": null,
  "sshMonitorId": null,
  "ftpMonitorId": null,
  "imapPopMonitorId": null,
  "dnsMonitorId": null,
  "customerIpId": null,
  "customerDomainId": null,
  "createdAt": "2026-06-29T10:00:00.000Z",
  "updatedAt": "2026-06-29T10:00:00.000Z"
}

Häufige FehlerAnkerlink kopieren