KRM API maintenance.goog/v1

maintenance.goog/v1

软件包 v1 包含维护政策 v1 API 组的 API 架构定义

DateTimeRange

来源： - MaintenanceExclusion

字段	说明
startDateTime 时间	拒绝期开始日期。与此时间段匹配的日期必须与开始日期相同或晚于开始日期。
endDateTime 时间	拒绝期结束日期。与此时间段匹配的日期必须早于结束日期。

DayOfWeek

基础类型： string

来源： - WeeklyCycle

MaintenanceExclusion

MaintenanceExclusion 是禁止进行维护的时间段，即使维护窗口允许进行维护也是如此。 MaintenanceExclusion 中的范围使用包含起始值但不包含结束值的半闭区间。在区间表示法中，这表示为 [start, end)。

来源： - MaintenancePolicySpec

字段	说明
dateTimeRange DateTimeRange	禁止进行维护的时间段。

MaintenancePolicy

来源： - MaintenancePolicyList

字段	说明
apiVersion 字符串	maintenance.goog/v1
kind 字符串	MaintenancePolicy
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec MaintenancePolicySpec
status MaintenancePolicyStatus

MaintenancePolicyBinding

来源： - MaintenancePolicyBindingList

字段	说明
apiVersion 字符串	maintenance.goog/v1
kind 字符串	MaintenancePolicyBinding
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec MaintenancePolicyBindingSpec
status MaintenancePolicyBindingStatus

MaintenancePolicyBindingList

字段	说明
apiVersion 字符串	maintenance.goog/v1
kind 字符串	MaintenancePolicyBindingList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items MaintenancePolicyBinding 数组

MaintenancePolicyBindingSpec

来源： - MaintenancePolicyBinding

字段	说明
maintenancePolicy MaintenancePolicyRef
resource MaintenancePolicyResourceRef

MaintenancePolicyBindingStatus

来源： - MaintenancePolicyBinding

字段	说明
conditions 条件数组	条件包含 MaintenancePolicyBindings 的条件。维护政策绑定控制器会设置“有效”条件。 以下是 reason 字段的已知值：- BindingDuplicated：控制器发现有多个绑定分配给给定资源，条件的状态将为 False。- MaintenancePolicyMissing：绑定所指向的维护政策缺失，相应条件的状态将为 False。- ResourceMissing：绑定所指向的资源缺失，条件的状态将为 False。- 有效：指定资源只有一个绑定，且两端都引用现有实体，条件的状态将为 True。

MaintenancePolicyList

字段	说明
apiVersion 字符串	maintenance.goog/v1
kind 字符串	MaintenancePolicyList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items MaintenancePolicy 数组

MaintenancePolicyRef

来源： - MaintenancePolicyBindingSpec

字段	说明
apiGroup 字符串
kind 字符串
name 字符串

MaintenancePolicyResourceRef

来源： - MaintenancePolicyBindingSpec

字段	说明
apiGroup 字符串
kind 字符串
name 字符串

MaintenancePolicySpec

来源： - MaintenancePolicy

字段	说明
maintenanceWindow MaintenanceWindow	应用于相应政策所涵盖服务的维护窗口。
maintenanceExclusions 对象（键：字符串，值：MaintenanceExclusion）	禁止维护的指定时间段，即使 maintenanceWindow 允许维护也不行。

MaintenancePolicyStatus

来源： - MaintenancePolicy

字段	说明
conditions 条件数组	Conditions 字段包含 MaintenancePolicies 的条件。维护政策控制器设置“MaintenanceAllowed”条件。 以下是 reason 字段的已知值：- InsideMaintenanceWindow：我们目前处于计划的维护窗口内，允许进行维护。 条件的状态将为 True。 - OutsideMaintenanceWindow：我们目前处于维护窗口内，但排除项处于有效状态，因此不允许进行维护。相应条件的状态将为 False。 - InsideMaintenanceExclusion：我们目前处于维护窗口之外，不允许进行维护。 相应条件的状态将为 False。

MaintenanceWindow

MaintenanceWindow 表示允许进行维护的时间段。 必须存在且只能存在一个相应字段。

来源： - MaintenancePolicySpec

字段	说明
weeklyCycle WeeklyCycle	每周循环。

TimeOfDay

基础类型： string TimeOfDay 是采用文本格式“HH:mm”表示的时间

来源： - WeeklyCycle

WeeklyCycle

WeeklyCycle 表示每周重复出现的操作时间窗口。

来源： - MaintenanceWindow

字段	说明
daysOfWeek DayOfWeek 数组	可以开始运营的星期几。可以指定一天或多天。
startTime TimeOfDay	一天内开始操作的时间。系统会采用世界协调时间 (UTC) 时区。
duration 时长	时间段的时长。