`maintenance_window`数据结构与参数说明-容器服务 Kubernetes 版 ACK-阿里云-容器服务 Kubernetes 版 ACK(ACK)-阿里云帮助中心

名称	类型	描述	示例值
	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