メンテナンスウィンドウを作成
サービスレベルの新しいメンテナンスウィンドウを作成するには、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 } } } }}