유지보수 기간 생성
서비스 수준에 대한 새 유지 관리 기간을 생성하려면 maintenanceWindowCreate 뮤테이션을 사용하십시오.
매개변수
| 매개변수 | 데이터 형식 | 설명 |
|---|---|---|
name | 문자열 | (필수) 유지보수 기간의 이름입니다. |
description | 문자열 | (선택 사항) 유지보수 기간에 대한 설명입니다. |
scope | ScopedReferenceInput | (필수) 유지보수 기간이 속한 범위입니다. id (계정 ID) 및 type (엔티티 범위 ― 서비스 수준 유지보수 기간에는 ACCOUNT 사용)이 포함됩니다. |
startTime | NaiveDateTime | (필수) ISO 8601 형식의 유지보수 기간 시작 시간입니다. 이 시간은 timezone 파라미터에 지정된 시간대로 해석해야 합니다. |
duration | 지속 기간 | (필수) ISO 8601 지속 시간 형식의 유지보수 기간입니다(예: 2시간의 경우 PT2H, 30분의 경우 PT30M). |
rrule | 문자열 | (선택 사항) iCalendar 형식(RFC 5545)의 유지보수 기간 반복 규칙입니다. 반복되는 유지보수 기간을 생성하려면 이를 사용하십시오. |
timezone | 문자열 | (필수) 유지보수 기간의 시간대(예: America/New_York, Europe/London). |
affectedEntityType | 문자열 | (필수) 영향을 받는 엔티티의 유형입니다. 서비스 수준 유지 관리 기간에 SERVICE_LEVEL 을(를) 사용하십시오. |
affectedEntities | [ID] | (선택 사항) 유지 관리 기간의 영향을 받는 엔티티 GUID 목록입니다. |
샘플 돌연변이
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 }}유지보수 기간 업데이트
기존 유지 관리 기간을 업데이트하려면 maintenanceWindowUpdate 뮤테이션을 사용하십시오.
매개변수
| 매개변수 | 데이터 형식 | 설명 |
|---|---|---|
id | ID | (필수) 업데이트할 유지보수 기간의 고유 식별자입니다. |
name | 문자열 | (선택 사항) 유지보수 기간의 새 이름입니다. |
description | 문자열 | (선택 사항) 유지보수 기간의 새 설명입니다. |
startTime | NaiveDateTime | (선택 사항) ISO 8601 형식의 새 시작 시간입니다. |
duration | 지속 기간 | (선택 사항) ISO 8601 기간 형식의 새 기간입니다. |
rrule | 문자열 | (선택 사항) iCalendar 형식의 새로운 반복 규칙입니다. |
timezone | 문자열 | (선택 사항) 새로운 시간대. |
affectedEntities | [ID] | (선택 사항) 유지보수 기간의 영향을 받는 엔티티 GUID의 새 목록입니다. |
샘플 돌연변이
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 }}유지보수 기간 삭제
유지 관리 기간을 삭제하려면 maintenanceWindowDelete 뮤테이션을 사용하십시오.
샘플 돌연변이
mutation { maintenanceWindowDelete(id: "INSERT_MAINTENANCE_WINDOW_ID") { id name }}ID별 유지보수 기간 쿼리
ID로 특정 유지보수 기간을 조회하려면 listByIds 쿼리를 사용하십시오.
샘플 쿼리
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 } } } } }}영향을 받는 엔티티별 유지보수 기간 쿼리
특정 엔티티에 영향을 미치는 모든 유지보수 기간을 검색하려면 listByAffectedEntityId 쿼리를 사용하십시오.
샘플 쿼리
query { actor { maintenanceWindow { listByAffectedEntityId(affectedEntityId: "INSERT_ENTITY_GUID") { maintenanceWindows { id name description startTime duration rrule timezone affectedEntityType affectedEntities } } } }}