Créer une fenêtre de maintenance
Utilisez la mutation maintenanceWindowCreate pour créer une nouvelle fenêtre de maintenance pour vos niveaux de service.
Paramètres
| paramètres | Type de données | Description |
|---|---|---|
name | Chaîne | (Obligatoire) Le nom de la fenêtre de maintenance. |
description | Chaîne | (Facultatif) Une description de la fenêtre de maintenance. |
scope | ScopedReferenceInput | (Requis) Le périmètre auquel appartient la fenêtre de maintenance. Contient id (l'ID du compte) et type (la portée de l'entité — utilisez ACCOUNT pour les fenêtres de maintenance de niveau de service). |
startTime | NaiveDateTime | (Requis) L'heure de début de la fenêtre de maintenance au format ISO 8601. Cette heure doit être interprétée dans le fuseau horaire spécifié dans le paramètre timezone. |
duration | Durée | (Requis) La durée de la fenêtre de maintenance au format de durée ISO 8601 (par exemple, PT2H pour 2 heures, PT30M pour 30 minutes). |
rrule | Chaîne | (Facultatif) La règle de récurrence de la fenêtre de maintenance au format iCalendar (RFC 5545). Utilisez ceci pour créer des fenêtres de maintenance récurrentes. |
timezone | Chaîne | (Requis) Le fuseau horaire de la fenêtre de maintenance (par exemple, America/New_York, Europe/London). |
affectedEntityType | Chaîne | (Requis) Le type des entités affectées. Utilisez SERVICE_LEVEL pour les fenêtres de maintenance de niveau de service. |
affectedEntities | [ID] | (Facultatif) La liste des GUID d'entité affectés par la fenêtre de maintenance. |
Mutation d'échantillon
mutation { maintenanceWindowCreate( maintenanceWindow: { name: "Monthly System Upgrade" description: "Scheduled maintenance for system upgrades" scope: { id: "INSERT_YOUR_ACCOUNT_ID", type: ACCOUNT } startTime: "2025-12-15T02:00:00" duration: "PT4H" rrule: "FREQ=MONTHLY;BYMONTHDAY=15" timezone: "America/New_York" affectedEntityType: "SERVICE_LEVEL" affectedEntities: ["INSERT_ENTITY_GUID_1", "INSERT_ENTITY_GUID_2"] } ) { id name description startTime duration rrule timezone affectedEntityType affectedEntities }}Mettre à jour une fenêtre de maintenance
Utilisez la mutation maintenanceWindowUpdate pour mettre à jour une fenêtre de maintenance existante.
Paramètres
| paramètres | Type de données | Description |
|---|---|---|
id | Identifiant | (Requis) L'identifiant unique de la fenêtre de maintenance à mettre à jour. |
name | Chaîne | (Facultatif) Le nouveau nom de la fenêtre de maintenance. |
description | Chaîne | (Facultatif) La nouvelle description de la fenêtre de maintenance. |
startTime | NaiveDateTime | (Facultatif) La nouvelle heure de début au format ISO 8601. |
duration | Durée | (Facultatif) La nouvelle durée au format de durée ISO 8601. |
rrule | Chaîne | (Facultatif) La nouvelle règle de récurrence au format iCalendar. |
timezone | Chaîne | (Facultatif) Le nouveau fuseau horaire. |
affectedEntities | [ID] | (Facultatif) La nouvelle liste des GUID d'entité affectés par la fenêtre de maintenance. |
Mutation d'échantillon
mutation { maintenanceWindowUpdate( id: "INSERT_MAINTENANCE_WINDOW_ID" maintenanceWindow: { name: "Updated System Upgrade Window" duration: "PT6H" affectedEntities: [ "INSERT_ENTITY_GUID_1" "INSERT_ENTITY_GUID_2" "INSERT_ENTITY_GUID_3" ] } ) { id name description startTime duration rrule timezone affectedEntityType affectedEntities }}Supprimer une fenêtre de maintenance
Utilisez la mutation maintenanceWindowDelete pour supprimer une fenêtre de maintenance.
Mutation d'échantillon
mutation { maintenanceWindowDelete(id: "INSERT_MAINTENANCE_WINDOW_ID") { id name }}Requêter les fenêtres de maintenance par ID
Utilisez la requête listByIds pour récupérer des fenêtres de maintenance spécifiques par leurs ID.
Exemple de requête
query { actor { maintenanceWindow { listByIds( ids: [ "INSERT_MAINTENANCE_WINDOW_ID_1" "INSERT_MAINTENANCE_WINDOW_ID_2" ] ) { maintenanceWindows { id name description startTime duration rrule timezone affectedEntityType affectedEntities scope { id type } metadata { createdAt createdBy updatedAt updatedBy } } } } }}Requête des fenêtres de maintenance par entité affectée
Utilisez la requête listByAffectedEntityId pour récupérer toutes les fenêtres de maintenance qui affectent une entité spécifique.
Exemple de requête
query { actor { maintenanceWindow { listByAffectedEntityId(affectedEntityId: "INSERT_ENTITY_GUID") { maintenanceWindows { id name description startTime duration rrule timezone affectedEntityType affectedEntities } } } }}Sujets connexes
Fenêtres de maintenance des niveaux de service
Découvrez ce que sont les fenêtres de maintenance et comment elles fonctionnent.
Planifier et gérer les fenêtres de maintenance
Apprenez à créer, modifier et supprimer des fenêtres de maintenance dans l'interface utilisateur.
Tutoriel NerdGraph : Configurer le niveau de service
Découvrez comment créer et gérer des SLI et des SLO avec NerdGraph.