diff --git a/content/zh-cn/docs/reference/kubernetes-api/_index.md b/content/zh-cn/docs/reference/kubernetes-api/_index.md
index 4b22d7271063f..81ea54f20ecee 100644
--- a/content/zh-cn/docs/reference/kubernetes-api/_index.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/_index.md
@@ -1,6 +1,6 @@
---
title: Kubernetes API
-weight: 30
+weight: 50
---
diff --git a/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/token-request-v1.md b/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/token-request-v1.md
index 5623e77427c9e..3c10e54f4c70a 100644
--- a/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/token-request-v1.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/authentication-resources/token-request-v1.md
@@ -70,7 +70,7 @@ TokenRequestSpec 包含客户端提供的令牌请求参数。
- **audiences** ([]string)，必需
diff --git a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta2.md b/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta3.md
similarity index 93%
rename from content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta2.md
rename to content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta3.md
index 4a8a2fdcdb8e8..eb9409ad00d45 100644
--- a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta2.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta3.md
@@ -1,28 +1,29 @@
---
api_metadata:
- apiVersion: "flowcontrol.apiserver.k8s.io/v1beta2"
- import: "k8s.io/api/flowcontrol/v1beta2"
+ apiVersion: "flowcontrol.apiserver.k8s.io/v1beta3"
+ import: "k8s.io/api/flowcontrol/v1beta3"
kind: "FlowSchema"
content_type: "api_reference"
description: "FlowSchema 定义一组流的模式。"
-title: "FlowSchema v1beta2"
+title: "FlowSchema v1beta3"
weight: 7
+auto_generated: true
---
-`apiVersion: flowcontrol.apiserver.k8s.io/v1beta2`
+`apiVersion: flowcontrol.apiserver.k8s.io/v1beta3`
-`import "k8s.io/api/flowcontrol/v1beta2"`
+`import "k8s.io/api/flowcontrol/v1beta3"`
## FlowSchema {#FlowSchema}
@@ -34,7 +35,7 @@ FlowSchema 定义一组流的模式。请注意，一个流由属性类似的一
-- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta2
+- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta3
- **kind**: FlowSchema
@@ -43,7 +44,7 @@ FlowSchema 定义一组流的模式。请注意，一个流由属性类似的一
`metadata` is the standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **spec** (}}">FlowSchemaSpec)
+- **spec** (}}">FlowSchemaSpec)
`spec` is the specification of the desired behavior of a FlowSchema. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-->
@@ -52,17 +53,17 @@ FlowSchema 定义一组流的模式。请注意，一个流由属性类似的一
`metadata` 是标准的对象元数据。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **spec** (}}">FlowSchemaSpec)
+- **spec** (}}">FlowSchemaSpec)
`spec` 是 FlowSchema 预期行为的规约。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-- **status** (}}">FlowSchemaStatus)
+- **status** (}}">FlowSchemaStatus)
`status` 是 FlowSchema 的当前状态。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
@@ -451,6 +452,8 @@ FlowSchemaStatus 表示 FlowSchema 的当前状态。
- **conditions** ([]FlowSchemaCondition)
+ **补丁策略：根据键 type 合并**
+
**Map：合并期间保留根据键 type 保留其唯一值**
`conditions` 是 FlowSchema 当前状况的列表。
@@ -529,7 +534,7 @@ FlowSchemaList 是 FlowSchema 对象的列表。
-- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta2
+- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta3
- **kind**: FlowSchemaList
@@ -538,7 +543,7 @@ FlowSchemaList 是 FlowSchema 对象的列表。
`metadata` is the standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **items** ([]}}">FlowSchema), required
+- **items** ([]}}">FlowSchema), required
`items` is a list of FlowSchemas.
-->
@@ -547,7 +552,7 @@ FlowSchemaList 是 FlowSchema 对象的列表。
`metadata` 是标准的列表元数据。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **items** ([]}}">FlowSchema)，必需
+- **items** ([]}}">FlowSchema)，必需
`items` 是 FlowSchemas 的列表。
@@ -565,7 +570,7 @@ FlowSchemaList 是 FlowSchema 对象的列表。
#### HTTP 请求
-GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
+GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
401: Unauthorized
@@ -600,7 +605,7 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
#### HTTP 请求
-GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status
+GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
401: Unauthorized
@@ -635,7 +640,7 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status
#### HTTP 请求
-GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas
+GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas
#### 响应
-200 (}}">FlowSchemaList): OK
+200 (}}">FlowSchemaList): OK
401: Unauthorized
@@ -709,11 +714,11 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas
#### HTTP 请求
-POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas
+POST /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas
#### 参数
-- **body**: }}">FlowSchema，必需
+- **body**: }}">FlowSchema，必需
- **dryRun** (**查询参数**): string
@@ -744,11 +749,11 @@ POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas
-->
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
-201 (}}">FlowSchema): Created
+201 (}}">FlowSchema): Created
-202 (}}">FlowSchema): Accepted
+202 (}}">FlowSchema): Accepted
401: Unauthorized
@@ -760,13 +765,13 @@ POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas
#### HTTP 请求
-PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
+PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
-201 (}}">FlowSchema): Created
+201 (}}">FlowSchema): Created
401: Unauthorized
@@ -815,13 +820,13 @@ PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
#### HTTP 请求
-PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status
+PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
-201 (}}">FlowSchema): Created
+201 (}}">FlowSchema): Created
401: Unauthorized
@@ -870,7 +875,7 @@ PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status
#### HTTP 请求
-PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
+PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
-201 (}}">FlowSchema): Created
+201 (}}">FlowSchema): Created
401: Unauthorized
@@ -930,7 +935,7 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
#### HTTP 请求
-PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status
+PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status
#### 响应
-200 (}}">FlowSchema): OK
+200 (}}">FlowSchema): OK
-201 (}}">FlowSchema): Created
+201 (}}">FlowSchema): Created
401: Unauthorized
@@ -990,7 +995,7 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status
#### HTTP 请求
-DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}
+DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
-`apiVersion: flowcontrol.apiserver.k8s.io/v1beta2`
+`apiVersion: flowcontrol.apiserver.k8s.io/v1beta3`
-`import "k8s.io/api/flowcontrol/v1beta2"`
+`import "k8s.io/api/flowcontrol/v1beta3"`
## PriorityLevelConfiguration {#PriorityLevelConfiguration}
@@ -33,7 +33,7 @@ PriorityLevelConfiguration 表示一个优先级的配置。
-- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta2
+- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta3
- **kind**: PriorityLevelConfiguration
@@ -42,7 +42,7 @@ PriorityLevelConfiguration 表示一个优先级的配置。
`metadata` is the standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **spec** (}}">PriorityLevelConfigurationSpec)
+- **spec** (}}">PriorityLevelConfigurationSpec)
`spec` is the specification of the desired behavior of a "request-priority". More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-->
@@ -51,17 +51,17 @@ PriorityLevelConfiguration 表示一个优先级的配置。
`metadata` 是标准的对象元数据。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **spec** (}}">PriorityLevelConfigurationSpec)
+- **spec** (}}">PriorityLevelConfigurationSpec)
`spec` 是 “request-priority” 预期行为的规约。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-- **status** (}}">PriorityLevelConfigurationStatus)
+- **status** (}}">PriorityLevelConfigurationStatus)
`status` 是 “请求优先级” 的当前状况。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
@@ -108,25 +108,40 @@ PriorityLevelConfigurationSpec 指定一个优先级的配置。
* 应如何处理超出此限制的请求？
- - **limited.assuredConcurrencyShares** (int32)
-
- `assuredConcurrencyShares` (ACS) 配置执行限制，这是在给定时间可以执行的、此优先级的请求数量的限制。
- ACS 必须是一个正数。服务器的并发限制（SCL）数量按其保证的并发份额划分到并发能力受限的各个优先级中。
- 这一计算会为所有这种优先级分别生成其确定的并发值（ACV），即一次可以执行的请求数量：
+ - **limited.borrowingLimitPercent** (int32)
+
+ `borrowingLimitPercent` 配置如果存在，则可用来限制此优先级级别可以从其他优先级级别中租借多少资源。
+ 该限制被称为该级别的 BorrowingConcurrencyLimit（BorrowingCL），它限制了该级别可以同时租借的资源总数。
+ 该字段保存了该限制与该级别标称并发限制之比。当此字段非空时，必须为正整数，并按以下方式计算限制值：
+
+ BorrowingCL(i) = round(NominalCL(i) * borrowingLimitPercent(i) / 100.0)
+
+ 该字段值可以大于100，表示该优先级可以大于自己标称并发限制（NominalCL）。当此字段为 `nil` 时，表示无限制。
+
+
+ LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )
+ -->
+
+ - **limited.lendablePercent** (int32)
- 较大的 ACS 值意味着（以影响所有其他优先级为代价）保留更多的并发请求。此字段的默认值为 30。
+ `lendablePercent` 规定了 NominalCL 可被其他优先级级别租借资源数百分比。
+ 此字段的值必须在 0 到 100 之间，包括 0 和 100，默认为 0。
+ 其他级别可以从该级别借用的资源数被称为此级别的 LendableConcurrencyLimit（LendableCL），定义如下。
+
+ LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )
+
+ - **limited.nominalConcurrencyShares** (int32)
+
+ `nominalConcurrencyShares`（NCS）用于计算该优先级级别的标称并发限制（NominalCL）。
+ NCS 表示可以在此优先级级别同时运行的席位数量上限，包括来自本优先级级别的请求，
+ 以及从此优先级级别租借席位的其他级别的请求。
+ 服务器的并发度限制（ServerCL）根据 NCS 值按比例分别给各 Limited 优先级级别：
+
+ NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[limited priority level k] NCS(k)
+
+ 较大的数字意味着更大的标称并发限制（NominalCL），但是这将牺牲其他 Limited 优先级级别的资源。该字段的默认值为 30。
+
## PriorityLevelConfigurationStatus {#PriorityLevelConfigurationStatus}
@@ -317,7 +353,7 @@ PriorityLevelConfigurationList 是 PriorityLevelConfiguration 对象的列表。
`metadata` 是标准的对象元数据。更多信息：
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-- **items** ([]}}">PriorityLevelConfiguration)，必需
+- **items** ([]}}">PriorityLevelConfiguration)，必需
`items` 是请求优先级设置的列表。
@@ -335,7 +371,7 @@ PriorityLevelConfigurationList 是 PriorityLevelConfiguration 对象的列表。
#### HTTP 请求
-GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}
+GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
401: Unauthorized
@@ -370,7 +406,7 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name
#### HTTP 请求
-GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}/status
+GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
401: Unauthorized
@@ -405,7 +441,7 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name
#### HTTP 请求
-GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations
+GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations
#### 响应
-200 (}}">PriorityLevelConfigurationList): OK
+200 (}}">PriorityLevelConfigurationList): OK
401: Unauthorized
@@ -479,11 +515,11 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations
#### HTTP 请求
-POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations
+POST /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations
#### 参数
-- **body**: }}">PriorityLevelConfiguration，必需
+- **body**: }}">PriorityLevelConfiguration，必需
- **dryRun** (**查询参数**): string
@@ -514,11 +550,11 @@ POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations
-->
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
-201 (}}">PriorityLevelConfiguration): Created
+201 (}}">PriorityLevelConfiguration): Created
-202 (}}">PriorityLevelConfiguration): Accepted
+202 (}}">PriorityLevelConfiguration): Accepted
401: Unauthorized
@@ -530,13 +566,13 @@ POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations
#### HTTP 请求
-PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}
+PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
-201 (}}">PriorityLevelConfiguration): Created
+201 (}}">PriorityLevelConfiguration): Created
401: Unauthorized
@@ -585,13 +621,13 @@ PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name
#### HTTP 请求
-PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}/status
+PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
-201 (}}">PriorityLevelConfiguration): Created
+201 (}}">PriorityLevelConfiguration): Created
401: Unauthorized
@@ -640,7 +676,7 @@ PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name
#### HTTP 请求
-PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}
+PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
-201 (}}">PriorityLevelConfiguration): Created
+201 (}}">PriorityLevelConfiguration): Created
401: Unauthorized
@@ -700,7 +736,7 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{na
#### HTTP 请求
-PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}/status
+PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status
#### 响应
-200 (}}">PriorityLevelConfiguration): OK
+200 (}}">PriorityLevelConfiguration): OK
-201 (}}">PriorityLevelConfiguration): Created
+201 (}}">PriorityLevelConfiguration): Created
401: Unauthorized
@@ -760,7 +796,7 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{na
#### HTTP 请求
-DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta2/prioritylevelconfigurations/{name}
+DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}
- **webhooks.rules.apiGroups** ([]string)
+ **原子性: 合并期间会被替换**
+
apiGroups 是资源所属的 API 组列表。'*' 是所有组。
如果存在 '*'，则列表的长度必须为 1。必需。
- **webhooks.rules.apiVersions** ([]string)
+ **原子性: 合并期间会被替换**
+
apiVersions 是资源所属的 API 版本列表。'*' 是所有版本。
如果存在 '*'，则列表的长度必须为 1。必需。
- **webhooks.rules.operations** ([]string)
+ **原子性: 合并期间会被替换**
+
operations 是准入 Webhook 所关心的操作 —— CREATE、UPDATE、DELETE、CONNECT
或用来指代所有已知操作以及将来可能添加的准入操作的 `*`。
如果存在 '*'，则列表的长度必须为 1。必需。