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 Condition 陣列	條件包含 MaintenancePolicyBindings 的條件。維護政策繫結控制器會設定「Valid」條件。以下是原因欄位的已知值：- 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 object (keys:string, values:MaintenanceExclusion)	禁止維護作業的命名週期，即使維護期間允許維護作業也是如此。

MaintenancePolicyStatus

出現位置： - MaintenancePolicy

欄位	說明
conditions Condition 陣列	條件欄位包含 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	一天內開始作業的時間。系統會採用世界標準時間。
duration 時間長度	時間範圍的長度。