Criar uma janela de manutenção
Use a mutação maintenanceWindowCreate para criar uma nova janela de manutenção para seus níveis de serviço.
Parâmetro
| Parâmetro | Tipo de dados | Descrição |
|---|---|---|
name | Corda | (Obrigatório) O nome da janela de manutenção. |
description | Corda | (Opcional) Uma descrição da janela de manutenção. |
scope | ScopedReferenceInput | (Obrigatório) O escopo ao qual a janela de manutenção pertence. Contém id (o ID da conta) e type (o escopo da entidade — use ACCOUNT para janelas de manutenção de nível de serviço). |
startTime | NaiveDateTime | (Obrigatório) O horário de início da janela de manutenção no formato ISO 8601. Este horário deve ser interpretado no fuso horário especificado no parâmetro timezone. |
duration | Duração | (Obrigatório) A duração da janela de manutenção no formato de duração ISO 8601 (por exemplo, PT2H para 2 horas, PT30M para 30 minutos). |
rrule | Corda | (Opcional) A regra de recorrência da janela de manutenção no formato iCalendar (RFC 5545). Use isso para criar janelas de manutenção recorrentes. |
timezone | Corda | (Obrigatório) O fuso horário da janela de manutenção (por exemplo, America/New_York, Europe/London). |
affectedEntityType | Corda | (Obrigatório) O tipo das entidades afetadas. Use SERVICE_LEVEL para janelas de manutenção de nível de serviço. |
affectedEntities | [ID] | (Opcional) A lista de GUIDs de entidade afetados pela janela de manutenção. |
Mutação de amostra
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 }}Atualizar uma janela de manutenção
Use a mutação maintenanceWindowUpdate para atualizar uma janela de manutenção existente.
Parâmetro
| Parâmetro | Tipo de dados | Descrição |
|---|---|---|
id | EU IA | (Obrigatório) O identificador exclusivo da janela de manutenção a ser atualizada. |
name | Corda | (Opcional) O novo nome da janela de manutenção. |
description | Corda | (Opcional) A nova descrição da janela de manutenção. |
startTime | NaiveDateTime | (Opcional) O novo horário de início no formato ISO 8601. |
duration | Duração | (Opcional) A nova duração no formato de duração ISO 8601. |
rrule | Corda | (Opcional) A nova regra de recorrência no formato iCalendar. |
timezone | Corda | (Opcional) O novo fuso horário. |
affectedEntities | [ID] | (Opcional) A nova lista de GUIDs de entidade afetados pela janela de manutenção. |
Mutação de amostra
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 }}Excluir uma janela de manutenção
Use a mutação maintenanceWindowDelete para excluir uma janela de manutenção.
Mutação de amostra
mutation { maintenanceWindowDelete(id: "INSERT_MAINTENANCE_WINDOW_ID") { id name }}Consulta de janelas de manutenção por IDs
Use a consulta listByIds para recuperar janelas de manutenção específicas por seus IDs.
Exemplo de consulta
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 janelas de manutenção por entidade afetada
Use a consulta listByAffectedEntityId para recuperar todas as janelas de manutenção que afetam uma entidade específica.
Exemplo de consulta
query { actor { maintenanceWindow { listByAffectedEntityId(affectedEntityId: "INSERT_ENTITY_GUID") { maintenanceWindows { id name description startTime duration rrule timezone affectedEntityType affectedEntities } } } }}Tópicos relacionados
Janelas de manutenção de nível de serviço
Saiba o que são janelas de manutenção e como elas funcionam.
Agendar e gerenciar janelas de manutenção
Aprenda a criar, editar e excluir janelas de manutenção na interface.
Tutorial NerdGraph: Configurar nível de serviço
Aprenda a criar e gerenciar SLIs e SLOs com o NerdGraph.