Fenêtres de maintenance

Planifiez des périodes de maintenance pour suspendre les alertes : création, démarrage, fin et annulation.

À quoi ça sert

Une fenêtre de maintenance déclare une période planifiée pendant laquelle des interventions sont prévues. Son principal effet : suspendre les alertes sur les hôtes et vérifications concernés, afin d'éviter une avalanche de notifications pendant une opération volontaire (déploiement, redémarrage, migration…). Vous choisissez aussi d'informer ou non vos abonnés (page de statut).

Le modèle d'une fenêtre

Champ	Type	Requis	Description
`id`	uuid	(généré)	Identifiant unique.
`title`	string	✅	Titre de la maintenance.
`description`	string	—	Détails de l'opération.
`start_time`	date (RFC3339)	✅	Début planifié.
`end_time`	date (RFC3339)	✅	Fin planifiée (doit être après le début).
`suppress_alerts`	booléen	—	Suspendre les alertes pendant la fenêtre. Défaut : `true`.
`notify_subscribers`	booléen	—	Informer les abonnés. Défaut : `true`.
`affected_checks`	tableau	—	Vérifications concernées.
`affected_hosts`	tableau	—	Hôtes concernés.
`status`	string	(géré)	`scheduled`, `active`, `completed` ou `cancelled`.

Cycle de vie

scheduled ──(start)──► active ──(end)──► completed
    │
    └──(cancel)──► cancelled

Une fenêtre est créée en scheduled. Vous pouvez la démarrer (→ active), la terminer (→ completed) ou l'annuler (→ cancelled). Seule une fenêtre scheduled peut être démarrée, et seule une fenêtre active peut être terminée.

Utilisation via le portail

La section Maintenance distingue les fenêtres à venir des fenêtres passées. Vous pouvez planifier une fenêtre, la démarrer, la terminer ou l'annuler, et choisir si elle suspend les alertes et notifie les abonnés.

Lister et consulter : tous les rôles. Créer, modifier, démarrer, terminer, annuler : owner et admin.

Utilisation via l'API

Lister

GET /api/v2/maintenance-windows

curl -s https://api.secumon.secuaas.ovh/api/v2/maintenance-windows \
  -H "Authorization: Bearer $SECUMON_TOKEN"

{
  "count": 1,
  "maintenance_windows": [
    {
      "id": "f0f1f2f3-1234-4abc-9def-aabbccddeeff",
      "title": "Mise à jour applicative web-prod-01",
      "start_time": "2026-06-24T02:00:00Z",
      "end_time": "2026-06-24T03:00:00Z",
      "suppress_alerts": true,
      "notify_subscribers": true,
      "status": "scheduled"
    }
  ]
}

Créer

POST /api/v2/maintenance-windows — title, start_time et end_time requis (RFC3339, fin après début).

curl -s -X POST https://api.secumon.secuaas.ovh/api/v2/maintenance-windows \
  -H "Authorization: Bearer $SECUMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Mise à jour applicative web-prod-01",
    "description": "Déploiement de la version 2.4, redémarrage du service.",
    "start_time": "2026-06-24T02:00:00Z",
    "end_time": "2026-06-24T03:00:00Z",
    "suppress_alerts": true,
    "notify_subscribers": true,
    "affected_hosts": ["8f3b1c2a-2d44-4e1a-9b77-0a1b2c3d4e5f"]
  }'

Réponse : 201 Created avec la fenêtre en statut scheduled.

Consulter et modifier

# Détail
curl -s https://api.secumon.secuaas.ovh/api/v2/maintenance-windows/f0f1f2f3-1234-4abc-9def-aabbccddeeff \
  -H "Authorization: Bearer $SECUMON_TOKEN"

# Modifier (champs partiels)
curl -s -X PUT https://api.secumon.secuaas.ovh/api/v2/maintenance-windows/f0f1f2f3-1234-4abc-9def-aabbccddeeff \
  -H "Authorization: Bearer $SECUMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "end_time": "2026-06-24T03:30:00Z" }'

Démarrer, terminer, annuler

# Démarrer (scheduled → active)
curl -s -X POST https://api.secumon.secuaas.ovh/api/v2/maintenance-windows/f0f1f2f3-1234-4abc-9def-aabbccddeeff/start \
  -H "Authorization: Bearer $SECUMON_TOKEN"

# Terminer (active → completed)
curl -s -X POST https://api.secumon.secuaas.ovh/api/v2/maintenance-windows/f0f1f2f3-1234-4abc-9def-aabbccddeeff/end \
  -H "Authorization: Bearer $SECUMON_TOKEN"

# Annuler (→ cancelled)
curl -s -X POST https://api.secumon.secuaas.ovh/api/v2/maintenance-windows/f0f1f2f3-1234-4abc-9def-aabbccddeeff/cancel \
  -H "Authorization: Bearer $SECUMON_TOKEN"

start et end renvoient la fenêtre mise à jour ; cancel renvoie 204 No Content. Tenter de démarrer une fenêtre non scheduled, ou de terminer une fenêtre non active, renvoie une erreur 400.

Cas d'usage

Déploiement planifié : créer une fenêtre couvrant l'opération, avec suppress_alerts: true, pour ne pas réveiller l'astreinte.
Communication proactive : laisser notify_subscribers: true pour informer vos utilisateurs via la page de statut.
Intervention prolongée : ajuster end_time en cours d'opération si la maintenance déborde.

Astuces

Ciblez précisément affected_hosts / affected_checks pour ne suspendre que ce qui est réellement impacté, et continuer à surveiller le reste.
Pensez à terminer la fenêtre dès la fin de l'opération : cela rétablit les alertes plus tôt si vous avez fini en avance.
Une fenêtre démarrée manuellement (/start) est utile quand l'intervention commence avant l'horaire prévu.

Fenêtres de maintenance

On this page