maintenance_window - Container Service for Kubernetes

名稱	類型	描述	樣本值
	object	叢集維護視窗。
duration	string	維護時長。取值範圍[1,24]，單位為小時。預設值：3h。	3h
enable	boolean	是否開啟維護視窗。取值： `true`：開啟維護視窗。 `false`：不開啟維護視窗。預設值：`false`。	false
exclusions	array	維護視窗排除項目清單，最多 10 項。排除項目優先順序高於維護視窗：即使目前處於維護視窗內，只要有生效的排除項目涵蓋該維運類型，則不執行。同一時刻多個排除項目生效時取聯集，其中 NoOperations 與 NoUpgrades 合計不超過 3 項。目前僅支援一次性時間段，不支援週期性設定。
	object
description	string	排除項目描述。最長 128 個字元，不支援 emoji 等 4 位元組字元。	封網期間禁止一切變更
end_time	string	排除項目生效結束時間。RFC3339 標準格式，必須晚於 start_time 且晚於目前時間。單條時長上限：NoOperations、NoUpgrades 和 NoCVEPatch 為 30 天，NoMinorUpgrades 為 180 天。	2026-11-15T00:00:00+08:00
scope	string	排除項目作用域，即在該時間段內禁止執行的主動維運類型。取值區分大小寫： NoOperations：禁止所有主動維運，包括叢集升級、元件升級、CVE 修復和 OS 映像更新； NoUpgrades：禁止叢集升級和元件升級，仍允許 CVE 修復和 ECS 計畫內事件回應； NoMinorUpgrades：僅禁止叢集 minor 版本升級，仍允許 patch 升級、元件升級和 CVE 修復； NoCVEPatch：禁止 CVE 自動修復。	NoOperations
start_time	string	排除項目生效起始時間。RFC3339 標準格式，需與 end_time 以及 maintenance_time 的時區偏移量保持一致。	2026-11-01T00:00:00+08:00
maintenance_time	string	維護起始時間。RFC3339 標準格式。	2020-10-15T12:31:00.000+08:00
recurrence	string	使用 RFC5545 Recurrence Rule 語法定義的維護視窗循環規則，目前僅支援 FREQ=WEEKLY，且不支援指定 COUNT 或 UNTIL。	FREQ=WEEKLY;INTERVAL=4;BYDAY=MO,TU
weekly_period	string	維護週期，多個值用英文半形逗號（,）分隔。取值：{Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday} 預設值：`Thursday`。	Monday,Thursday

object

叢集維護視窗。

duration

string

維護時長。取值範圍[1,24]，單位為小時。

預設值：3h。

3h

enable

boolean

是否開啟維護視窗。取值：

true：開啟維護視窗。
false：不開啟維護視窗。

預設值：false。

false

exclusions

array

維護視窗排除項目清單，最多 10 項。排除項目優先順序高於維護視窗：即使目前處於維護視窗內，只要有生效的排除項目涵蓋該維運類型，則不執行。同一時刻多個排除項目生效時取聯集，其中 NoOperations 與 NoUpgrades 合計不超過 3 項。目前僅支援一次性時間段，不支援週期性設定。

object

description

string

排除項目描述。最長 128 個字元，不支援 emoji 等 4 位元組字元。

封網期間禁止一切變更

end_time

string

排除項目生效結束時間。RFC3339 標準格式，必須晚於 start_time 且晚於目前時間。單條時長上限：NoOperations、NoUpgrades 和 NoCVEPatch 為 30 天，NoMinorUpgrades 為 180 天。

2026-11-15T00:00:00+08:00

scope

string

排除項目作用域，即在該時間段內禁止執行的主動維運類型。取值區分大小寫：

NoOperations：禁止所有主動維運，包括叢集升級、元件升級、CVE 修復和 OS 映像更新；
NoUpgrades：禁止叢集升級和元件升級，仍允許 CVE 修復和 ECS 計畫內事件回應；
NoMinorUpgrades：僅禁止叢集 minor 版本升級，仍允許 patch 升級、元件升級和 CVE 修復；
NoCVEPatch：禁止 CVE 自動修復。

NoOperations

start_time

string

排除項目生效起始時間。RFC3339 標準格式，需與 end_time 以及 maintenance_time 的時區偏移量保持一致。

2026-11-01T00:00:00+08:00

maintenance_time

string

維護起始時間。RFC3339 標準格式。

2020-10-15T12:31:00.000+08:00

recurrence

string

使用 RFC5545 Recurrence Rule 語法定義的維護視窗循環規則，目前僅支援 FREQ=WEEKLY，且不支援指定 COUNT 或 UNTIL。

FREQ=WEEKLY;INTERVAL=4;BYDAY=MO,TU

weekly_period

string

維護週期，多個值用英文半形逗號（,）分隔。取值：{Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday}

預設值：Thursday。

Monday,Thursday