---
title: "Maintenance Windows"
description: "Erstelle und verwalte Wartungsfenster, um Alarme bei geplanten Arbeiten zu unterdrücken. Fenster können einen einzelnen Monitor, mehrere Monitore, einen gesamten Kunden oder alle Monitore mit einem bestimmten Tag abdecken."
---

Wartungsfenster unterdrücken Alarme für die betroffenen Monitore während eines geplanten Zeitraums. Während ein Fenster aktiv ist, gilt der betroffene Monitor als **in Wartung**: es werden keine Alarme ausgelöst und, wenn der Kunde eine Statusseite hat, wird der Service als **Wartung** statt **Beeinträchtigt** angezeigt.

## Zieloptionen

Ein Fenster kann Monitore auf vier Arten abdecken (gegenseitig ausschließend, außer dass `targets` und `tagIds` kombiniert werden können):

| Modus | Angabe |
|-------|--------|
| **Einzelner Monitor (Legacy)** | Eines der Legacy-ID-Felder: `websiteId`, `icmpMonitorId`, `smtpMonitorId`, `sshMonitorId`, `ftpMonitorId`, `imapPopMonitorId`, `dnsMonitorId`, `customerIpId`, `customerDomainId` |
| **Mehrere Monitore** | `targets: [{ type, id }, ...]` Array |
| **Nach Tag (dynamisch)** | `tagIds: [number, ...]`: deckt alle Monitore des Kunden des Fensters ab, die den Tag aktuell tragen; später getaggte Monitore werden automatisch abgedeckt |
| **Kunden-Ebene** | `customerId` allein: deckt jeden Monitor des Kunden ab |

## Dynamisches Tag-Verhalten

Tag-basierte Fenster werden vom Monitoring-Worker live ausgewertet: Jedes Mal, wenn ein Check-Ergebnis eintrifft, ermittelt der Worker, welche Wartungsfenster auf diesen Monitor zutreffen, indem er die aktuellen Tags des Monitors nachschlägt. Das bedeutet, dass ein Monitor, der *nach* der Fenstererstellung getaggt wird, automatisch abgedeckt ist, ohne das Fenster zu aktualisieren. Das Entfernen eines Tags von einem Monitor beendet die Abdeckung sofort.

Tag-Fenster sind an einen einzelnen Kunden gebunden. Es ist nicht möglich, ein organisationsweites Tag-Fenster zu erstellen, das mehrere Kunden umfasst.

## Endpunkte

- [Maintenance Windows auflisten](./list)
- [Maintenance Window erstellen](./create)
- [Maintenance Window abrufen](./get)
- [Maintenance Window aktualisieren](./update)
- [Maintenance Window löschen](./delete)