Crear una ventana de mantenimiento
Utilice la mutación maintenanceWindowCreate para crear una nueva ventana de mantenimiento para sus niveles de servicio.
Parámetros
| Parámetro | Tipo de datos | Descripción |
|---|---|---|
name | Cadena | (Obligatorio) El nombre de la ventana de mantenimiento. |
description | Cadena | (Opcional) Una descripción de la ventana de mantenimiento. |
scope | ScopedReferenceInput | (Obligatorio) El ámbito al que pertenece la ventana de mantenimiento. Contiene id (el ID de la cuenta) y type (el alcance de la entidad — use ACCOUNT para las ventanas de mantenimiento del nivel de servicio). |
startTime | NaiveDateTime | (Obligatorio) La hora de inicio de la ventana de mantenimiento en formato ISO 8601. Esta hora debe interpretarse en la zona horaria especificada en el parámetro timezone. |
duration | Duración | (Obligatorio) La duración de la ventana de mantenimiento en formato de duración ISO 8601 (por ejemplo, PT2H para 2 horas, PT30M para 30 minutos). |
rrule | Cadena | (Opcional) La regla de recurrencia de la ventana de mantenimiento en formato iCalendar (RFC 5545). Utilice esto para crear ventanas de mantenimiento recurrentes. |
timezone | Cadena | (Obligatorio) La zona horaria de la ventana de mantenimiento (por ejemplo, America/New_York, Europe/London). |
affectedEntityType | Cadena | (Obligatorio) El tipo de las entidades afectadas. Use SERVICE_LEVEL para las ventanas de mantenimiento de nivel de servicio. |
affectedEntities | [ID] | (Opcional) La lista de GUID de entidades afectadas por la ventana de mantenimiento. |
Mutación de muestra
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 }}Actualizar una ventana de mantenimiento
Utilice la mutación maintenanceWindowUpdate para actualizar una ventana de mantenimiento existente.
Parámetros
| Parámetro | Tipo de datos | Descripción |
|---|---|---|
id | IDENTIFICACIÓN | (Obligatorio) El identificador único de la ventana de mantenimiento a actualizar. |
name | Cadena | (Opcional) El nuevo nombre de la ventana de mantenimiento. |
description | Cadena | (Opcional) La nueva descripción de la ventana de mantenimiento. |
startTime | NaiveDateTime | (Opcional) La nueva hora de inicio en formato ISO 8601. |
duration | Duración | (Opcional) La nueva duración en formato de duración ISO 8601. |
rrule | Cadena | (Opcional) La nueva regla de recurrencia en formato iCalendar. |
timezone | Cadena | (Opcional) La nueva zona horaria. |
affectedEntities | [ID] | (Opcional) La nueva lista de GUID de entidades afectadas por la ventana de mantenimiento. |
Mutación de muestra
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 }}Eliminar una ventana de mantenimiento
Usa la mutación maintenanceWindowDelete para eliminar una ventana de mantenimiento.
Mutación de muestra
mutation { maintenanceWindowDelete(id: "INSERT_MAINTENANCE_WINDOW_ID") { id name }}Consulta de ventanas de mantenimiento por ID
Utilice la consulta listByIds para recuperar ventanas de mantenimiento específicas por sus ID.
Consulta de muestra
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 } } } } }}Consulta de ventanas de mantenimiento por entidad afectada
Utilice la consulta listByAffectedEntityId para recuperar todas las ventanas de mantenimiento que afectan a una entidad específica.
Consulta de muestra
query { actor { maintenanceWindow { listByAffectedEntityId(affectedEntityId: "INSERT_ENTITY_GUID") { maintenanceWindows { id name description startTime duration rrule timezone affectedEntityType affectedEntities } } } }}Temas relacionados
Ventanas de mantenimiento de nivel de servicio
Aprenda qué son las ventanas de mantenimiento y cómo funcionan.
Programar y administrar ventanas de mantenimiento
Aprenda a crear, editar y eliminar ventanas de mantenimiento en la UI.
Tutorial de NerdGraph: Configurar niveles de servicio
Aprenda a crear y gestionar SLIs y SLOs con NerdGraph.