diff --git a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md index 128786695ae..152b0c4d48b 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/pod-disruption-budget-v1.md @@ -9,7 +9,7 @@ title: "PodDisruptionBudget" weight: 4 --- - PodDisruptionBudget 是一个对象，用于定义可能对一组 Pod 造成的最大干扰。 @@ -37,29 +37,29 @@ PodDisruptionBudget 是一个对象，用于定义可能对一组 Pod 造成的 - **kind**: PodDisruptionBudget - - **metadata** (}}">ObjectMeta) 标准的对象元数据。 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。 - - **spec** (}}">PodDisruptionBudgetSpec) PodDisruptionBudget 预期行为的规约。 - - **status** (}}">PodDisruptionBudgetStatus) @@ -68,20 +68,20 @@ PodDisruptionBudget 是一个对象，用于定义可能对一组 Pod 造成的 ## PodDisruptionBudgetSpec {#PodDisruptionBudgetSpec} - PodDisruptionBudgetSpec 是对 PodDisruptionBudget 的描述。
- - **maxUnavailable** (IntOrString) @@ -93,13 +93,13 @@ PodDisruptionBudgetSpec 是对 PodDisruptionBudget 的描述。 IntOrString 是一种可以包含 int32 或字符串数值的类型。在 JSON 或 YAML 编组和解组时， 会生成或使用内部类型。例如，此类型允许你定义一个可以接受名称或数字的 JSON 字段。 - - **minAvailable** (IntOrString) @@ -111,10 +111,10 @@ PodDisruptionBudgetSpec 是对 PodDisruptionBudget 的描述。 IntOrString 是一种可以包含 int32 或字符串数值的类型。在 JSON 或 YAML 编组和解组时， 会生成或使用内部类型。例如，此类型允许你定义一个可以接受名称或数字的 JSON 字段。 - - **selector** (}}">LabelSelector) @@ -137,7 +137,7 @@ PodDisruptionBudgetSpec 是对 PodDisruptionBudget 的描述。 IfHealthyBudget 策略意味着正在运行（status.phase="Running"）但还不健康的 Pod @@ -147,10 +147,10 @@ PodDisruptionBudgetSpec 是对 PodDisruptionBudget 的描述。 AlwaysAllow 策略意味着无论是否满足 PDB 中的条件，所有正在运行（status.phase="Running"）但还不健康的 Pod 都被视为受干扰且可以被驱逐。这意味着受干扰应用的透视运行 Pod 可能没有机会变得健康。 健康的 Pod 将受到 PDB 的驱逐。 - + 将来可能会添加其他策略。如果客户端在该字段遇到未识别的策略，则做出驱逐决定的客户端应禁止驱逐不健康的 Pod。 @@ -159,90 +159,90 @@ PodDisruptionBudgetSpec 是对 PodDisruptionBudget 的描述。 ## PodDisruptionBudgetStatus {#PodDisruptionBudgetStatus} - PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。状态可能会反映系统的实际状态。
- - **currentHealthy** (int32), 必需 当前健康 Pod 的数量。 - - **desiredHealthy** (int32), 必需 健康 Pod 的最小期望值。 - -- **disruptionsAllowed** (int32), 必需 - +- **disruptionsAllowed** (int32), 必需 + 当前允许的 Pod 干扰计数。 - **conditions** ([]Condition) - **补丁策略：根据 `type` 键执行合并操作** - + **Map：键 type 的唯一值将在合并期间被保留** - + conditions 包含 PDB 的状况。干扰控制器会设置 DisruptionAllowed 状况。 以下是 reason 字段的已知值（将来可能会添加其他原因）： - + - SyncFailed：控制器遇到错误并且无法计算允许的干扰计数。因此不允许任何干扰，且状况的状态将变为 False。 - InsufficientPods：Pod 的数量只能小于或等于 PodDisruptionBudget 要求的数量。 不允许任何干扰，且状况的状态将是 False。 - SufficientPods：Pod 个数超出 PodDisruptionBudget 所要求的阈值。 此状况为 True 时，基于 disruptsAllowed 属性确定所允许的干扰数目。 - Condition 包含此 API 资源当前状态的一个方面的详细信息。 - - **conditions.lastTransitionTime** (Time), 必需 @@ -254,20 +254,20 @@ PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。 Time 是 time.Time 的包装器，它支持对 YAML 和 JSON 的正确编组。 time 包的许多工厂方法提供了包装器。 - - **conditions.message** (string), 必需 message 是一条人类可读的消息，指示有关转换的详细信息。它可能是一个空字符串。 - - **conditions.reason** (string), 必需 @@ -276,30 +276,30 @@ PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。 特定状况类型的生产者可以定义该字段的预期值和含义，以及这些值是否可被视为有保证的 API。 该值应该是 CamelCase 字符串。此字段不能为空。 - - **conditions.status** (string), 必需 状况的状态为 True、False、Unknown 之一。 - - **conditions.type** (string), 必需 CamelCase 或 foo.example.com/CamelCase 形式的状况类型。 - - **conditions.observedGeneration** (int64) @@ -308,10 +308,10 @@ PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。 例如，如果 .metadata.generation 当前为 12，但 .status.conditions[x].observedGeneration 为 9， 则状况相对于实例的当前状态已过期。 - - **disruptedPods** (map[string]Time) @@ -324,16 +324,16 @@ PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。 如果一切顺利，此映射大部分时间应该是空的。映射中的存在大量条目可能表明 Pod 删除存在问题。 - Time 是 time.Time 的包装器，它支持对 YAML 和 JSON 的正确编组。 time 包的许多工厂方法提供了包装器。 - - **observedGeneration** (int64) @@ -343,8 +343,8 @@ PodDisruptionBudgetStatus 表示有关此 PodDisruptionBudget 状态的信息。 ## PodDisruptionBudgetList {#PodDisruptionBudgetList} - PodDisruptionBudgetList 是 PodDisruptionBudget 的集合。 @@ -355,10 +355,10 @@ PodDisruptionBudgetList 是 PodDisruptionBudget 的集合。 - **kind**: PodDisruptionBudgetList - - **metadata** (}}">ListMeta) @@ -366,27 +366,28 @@ PodDisruptionBudgetList 是 PodDisruptionBudget 的集合。 标准的对象元数据。 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。 - + - **items** ([]}}">PodDisruptionBudget), 必需 items 是 PodDisruptionBudgets 的列表。 - ## 操作 {#Operations}
- ### `get` 读取指定的 PodDisruptionBudget @@ -395,40 +396,40 @@ PodDisruptionBudgetList 是 PodDisruptionBudget 的集合。 GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} - #### 参数 - - **name** (**路径参数**): string, 必需 PodDisruptionBudget 的名称。 - - **namespace** (**路径参数**): string, 必需 }}">namespace - - **pretty** (**查询参数**): string }}">pretty - #### 响应 @@ -436,10 +437,10 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} 401: Unauthorized - ### `get` 读取指定 PodDisruptionBudget 的状态 @@ -447,40 +448,40 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status - #### 参数 - - **name** (**路径参数**): string, 必需 PodDisruptionBudget 的名称。 - - **namespace** (**路径参数**): string, 必需 }}">namespace - - **pretty** (**查询参数**): string }}">pretty - 响应 @@ -488,10 +489,10 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status 401: Unauthorized - ### `list` 列出或监视 PodDisruptionBudget 类型的对象 @@ -499,33 +500,33 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets - #### 参数 - - **namespace** (**路径参数**): string, 必需 }}">namespace - - **allowWatchBookmarks** (**查询参数**): boolean }}">allowWatchBookmarks - - **continue** (**查询参数**): string @@ -533,77 +534,77 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets - **fieldSelector** (**查询参数**): string }}">fieldSelector - - **labelSelector** (**查询参数**): string }}">labelSelector - - **limit** (**查询参数**): integer }}">limit - - **pretty** (**查询参数**): string }}">pretty - - **resourceVersion** (**查询参数**): string }}">resourceVersion - - **resourceVersionMatch** (**查询参数**): string }}">resourceVersionMatch - - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds - - **watch** (**查询参数**): boolean }}">watch - #### 响应 @@ -611,10 +612,10 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets 401: Unauthorized - ### `list` 列出或监视 PodDisruptionBudget 类型的对象 @@ -622,30 +623,30 @@ GET /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets GET /apis/policy/v1/poddisruptionbudgets - #### 参数 - - **allowWatchBookmarks** (**查询参数**): boolean }}">allowWatchBookmarks - - **continue** (**查询参数**): string }}">continue - - **labelSelector** (**查询参数**): string }}">labelSelector - - **limit** (**查询参数**): integer }}">limit - - **pretty** (**查询参数**): string }}">pretty - - **resourceVersion** (**查询参数**): string }}">resourceVersion - - **resourceVersionMatch** (**查询参数**): string }}">resourceVersionMatch - - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds - - **watch** (**查询参数**): boolean }}">watch #### 响应 @@ -726,74 +727,74 @@ GET /apis/policy/v1/poddisruptionbudgets 401: Unauthorized - ### `create` 创建一个 PodDisruptionBudget #### HTTP 请求 POST /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets - #### 参数 - - **namespace** (**路径参数**): string, 必需 }}">namespace - -- **body**: }}">PodDisruptionBudget, -必需 +- **body**: }}">PodDisruptionBudget, + 必需 - - **dryRun** (**查询参数**): string }}">dryRun - - **fieldManager** (**查询参数**): string }}">fieldManager - - **fieldValidation** (**查询参数**): string }}">fieldValidation - - **pretty** (**查询参数**): string }}">pretty - #### 响应 @@ -805,10 +806,10 @@ POST /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets 401: Unauthorized - ### `update` 替换指定的 PodDisruptionBudget @@ -816,96 +817,12 @@ POST /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets PUT /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} - #### 参数 - -- **name** (**路径参数**): string, 必需 - - PodDisruptionBudget 的名称。 - - -- **namespace** (**路径参数**): string, 必需 - - }}">namespace - - -- **body**: }}">PodDisruptionBudget, -必需 - - -- **dryRun** (**查询参数**): string - - }}">dryRun - - -- **fieldManager** (**查询参数**): string - - }}">fieldManager - - -- **fieldValidation** (**查询参数**): string - - }}">fieldValidation - - - - -#### 响应 - -200 (}}">PodDisruptionBudget): OK - -201 (}}">PodDisruptionBudget): Created - -401: Unauthorized - - -### `update` 替换指定 PodDisruptionBudget 的状态 - -#### HTTP 请求 - -PUT /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status - - -#### 参数 - - - **namespace** (**路径参数**): string, 必需 }}">namespace - -- **body**: }}">PodDisruptionBudget, -必需 +- **body**: }}">PodDisruptionBudget, + 必需 - -- **dryRun** (**查询参数**): string - - }}">dryRun}}">fieldManager ---> -- **fieldManager** (**查询参数**): string - - }}">fieldManager - - -- **fieldValidation** (**查询参数**): string - - }}">fieldValidation - - - - -#### 响应 - -200 (}}">PodDisruptionBudget): OK - -201 (}}">PodDisruptionBudget): Created - -401: Unauthorized - - -### `patch` 部分更新指定的 PodDisruptionBudget -#### HTTP 请求 - -PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} - - -#### 参数 - - -- **name** (**路径参数**): string, 必需 - - PodDisruptionBudget 的名称 - - -- **namespace** (**路径参数**): string, 必需 - - }}">namespace - - - -- **body**: }}">Patch, 必需 - - - **dryRun** (**查询参数**): string }}">dryRun - - **fieldManager** (**查询参数**): string }}">fieldManager - - **fieldValidation** (**查询参数**): string }}">fieldValidation - -- **force** (**查询参数**): boolean - - }}">force - - + + #### 响应 @@ -1068,91 +889,81 @@ PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} 401: Unauthorized - -### `patch` 部分更新指定 PodDisruptionBudget 的状态 +### `update` 替换指定 PodDisruptionBudget 的状态 + #### HTTP 请求 -PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status +PUT /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status - #### 参数 - - **name** (**路径参数**): string, 必需 PodDisruptionBudget 的名称。 - - **namespace** (**路径参数**): string, 必需 }}">namespace - -- **body**: }}">Patch, 必需 +- **body**: }}">PodDisruptionBudget, + 必需 - - **dryRun** (**查询参数**): string - }}">dryRun + }}">dryRun}}">fieldManager + }}">fieldManager --> - **fieldManager** (**查询参数**): string }}">fieldManager - - **fieldValidation** (**查询参数**): string }}">fieldValidation -- **force** (**查询参数**): boolean - - }}">force - - - **pretty** (**查询参数**): string }}">pretty +--> #### 响应 @@ -1162,10 +973,201 @@ PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status 401: Unauthorized - +### `patch` 部分更新指定的 PodDisruptionBudget + +#### HTTP 请求 + +PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} + + +#### 参数 + + +- **name** (**路径参数**): string, 必需 + + PodDisruptionBudget 的名称 + + +- **namespace** (**路径参数**): string, 必需 + + }}">namespace + + + +- **body**: }}">Patch, 必需 + + +- **dryRun** (**查询参数**): string + + }}">dryRun + + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + + +- **force** (**查询参数**): boolean + + }}">force + + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">PodDisruptionBudget): OK + +201 (}}">PodDisruptionBudget): Created + +401: Unauthorized + + +### `patch` 部分更新指定 PodDisruptionBudget 的状态 + +#### HTTP 请求 + +PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status + + +#### 参数 + + +- **name** (**路径参数**): string, 必需 + + PodDisruptionBudget 的名称。 + + +- **namespace** (**路径参数**): string, 必需 + + }}">namespace + + +- **body**: }}">Patch, 必需 + + +- **dryRun** (**查询参数**): string + + }}">dryRun + + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + + +- **force** (**查询参数**): boolean + + }}">force + + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">PodDisruptionBudget): OK + +201 (}}">PodDisruptionBudget): Created + +401: Unauthorized + + ### `delete` 删除 PodDisruptionBudget @@ -1173,24 +1175,24 @@ PATCH /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name}/status DELETE /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} - #### 参数 - - **name** (**路径参数**): string, 必需 PodDisruptionBudget 的名称。 - - **namespace** (**路径参数**): string, 必需 @@ -1198,7 +1200,7 @@ DELETE /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} - **body**: }}">DeleteOptions - - **gracePeriodSeconds** (**查询参数**): integer }}">gracePeriodSeconds - - **pretty** (**查询参数**): string }}">pretty - - **propagationPolicy** (**查询参数**): string }}">propagationPolicy - #### 响应 @@ -1245,10 +1247,10 @@ DELETE /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} 401: Unauthorized - ### `deletecollection` 删除 PodDisruptionBudget 的集合 @@ -1256,15 +1258,15 @@ DELETE /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets/{name} DELETE /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets - #### 参数 - - **namespace** (**路径参数**): string, 必需 @@ -1272,43 +1274,43 @@ DELETE /apis/policy/v1/namespaces/{namespace}/poddisruptionbudgets - **body**: }}">DeleteOptions - - **continue** (**查询参数**): string }}">continue - - **dryRun** (**查询参数**): string }}">dryRun - - **fieldSelector** (**查询参数**): string }}">fieldSelector - - **gracePeriodSeconds** (**查询参数**): integer }}">gracePeriodSeconds - - **pretty** (**查询参数**): string }}">pretty - - **propagationPolicy** (**查询参数**): string }}">propagationPolicy - - **resourceVersionMatch** (**查询参数**): string }}">resourceVersionMatch - - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds - #### 响应 200 (}}">Status): OK 401: Unauthorized -