From 5ddd60c2d0f68ca83f3a1f654671b00bfe19be9d Mon Sep 17 00:00:00 2001 From: windsonsea Date: Fri, 6 Sep 2024 09:15:13 +0800 Subject: [PATCH] [zh] Add priority-level-configuration-v1.md --- .../priority-level-configuration-v1.md} | 128 +++++++++--------- 1 file changed, 66 insertions(+), 62 deletions(-) rename content/zh-cn/docs/reference/kubernetes-api/{cluster-resources/priority-level-configuration-v1beta3.md => policy-resources/priority-level-configuration-v1.md} (85%) diff --git a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/priority-level-configuration-v1beta3.md b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/priority-level-configuration-v1.md similarity index 85% rename from content/zh-cn/docs/reference/kubernetes-api/cluster-resources/priority-level-configuration-v1beta3.md rename to content/zh-cn/docs/reference/kubernetes-api/policy-resources/priority-level-configuration-v1.md index e4dd4b6ada..5c271e1fff 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/priority-level-configuration-v1beta3.md +++ b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/priority-level-configuration-v1.md @@ -1,28 +1,28 @@ --- api_metadata: - apiVersion: "flowcontrol.apiserver.k8s.io/v1beta3" - import: "k8s.io/api/flowcontrol/v1beta3" + apiVersion: "flowcontrol.apiserver.k8s.io/v1" + import: "k8s.io/api/flowcontrol/v1" kind: "PriorityLevelConfiguration" content_type: "api_reference" description: "PriorityLevelConfiguration 表示一个优先级的配置。" -title: "PriorityLevelConfiguration v1beta3" -weight: 8 +title: "PriorityLevelConfiguration v1" +weight: 6 --- -`apiVersion: flowcontrol.apiserver.k8s.io/v1beta3` +`apiVersion: flowcontrol.apiserver.k8s.io/v1` -`import "k8s.io/api/flowcontrol/v1beta3"` +`import "k8s.io/api/flowcontrol/v1"` ## PriorityLevelConfiguration {#PriorityLevelConfiguration} @@ -33,7 +33,7 @@ PriorityLevelConfiguration 表示一个优先级的配置。
-- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta3 +- **apiVersion**: flowcontrol.apiserver.k8s.io/v1 - **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 @@ -75,18 +75,6 @@ PriorityLevelConfigurationSpec 指定一个优先级的配置。
- -- **type** (string)，必需 - - `type` 指示此优先级是否遵从有关请求执行的限制。 - 取值为 `"Exempt"` 意味着此优先级的请求不遵从某个限制（且因此从不排队）且不会减损其他优先级可用的容量。 - 取值为 `"Limited"` 意味着 (a) 此优先级的请求遵从这些限制且 - (b) 服务器某些受限的容量仅可用于此优先级。必需。 - - **exempt** (ExemptPriorityLevelConfiguration) - **limited.nominalConcurrencyShares** (int32) @@ -294,7 +282,19 @@ PriorityLevelConfigurationSpec 指定一个优先级的配置。 NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k) - 较大的数字意味着更大的标称并发限制，但是这将牺牲其他优先级的资源。该字段的默认值为 30。 + 较大的数字意味着更大的标称并发限制，但是这将牺牲其他优先级的资源。 + + +- **type** (string)，必需 + + `type` 指示此优先级是否遵从有关请求执行的限制。 + 取值为 `"Exempt"` 意味着此优先级的请求不遵从某个限制（且因此从不排队）且不会减损其他优先级可用的容量。 + 取值为 `"Limited"` 意味着 (a) 此优先级的请求遵从这些限制且 + (b) 服务器某些受限的容量仅可用于此优先级。必需。 ## PriorityLevelConfigurationStatus {#PriorityLevelConfigurationStatus} @@ -308,6 +308,8 @@ PriorityLevelConfigurationStatus 表示 “请求优先级” 的当前状况。 - **conditions** ([]PriorityLevelConfigurationCondition) + **补丁策略：基于键 `type` 合并** + **Map：合并期间保留根据键 type 保留其唯一值** `conditions` 是 “请求优先级” 的当前状况。 @@ -386,7 +390,7 @@ PriorityLevelConfigurationList 是 PriorityLevelConfiguration 对象的列表。
-- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta3 +- **apiVersion**: flowcontrol.apiserver.k8s.io/v1 - **kind**: PriorityLevelConfigurationList @@ -395,7 +399,7 @@ PriorityLevelConfigurationList 是 PriorityLevelConfiguration 对象的列表。 `metadata` is the standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata -- **items** ([]}}">PriorityLevelConfiguration), required +- **items** ([]}}">PriorityLevelConfiguration), required `items` is a list of request-priorities. --> @@ -404,7 +408,7 @@ PriorityLevelConfigurationList 是 PriorityLevelConfiguration 对象的列表。 `metadata` 是标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata -- **items** ([]}}">PriorityLevelConfiguration)，必需 +- **items** ([]}}">PriorityLevelConfiguration)，必需 `items` 是请求优先级设置的列表。 @@ -422,7 +426,7 @@ PriorityLevelConfigurationList 是 PriorityLevelConfiguration 对象的列表。 #### HTTP 请求 -GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name} +GET /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name} #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK 401: Unauthorized @@ -457,7 +461,7 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name #### HTTP 请求 -GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status +GET /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}/status #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK 401: Unauthorized @@ -492,7 +496,7 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name #### HTTP 请求 -GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations +GET /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations #### 响应 -200 (}}">PriorityLevelConfigurationList): OK +200 (}}">PriorityLevelConfigurationList): OK 401: Unauthorized @@ -571,11 +575,11 @@ GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations #### HTTP 请求 -POST /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations +POST /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations #### 参数 -- **body**: }}">PriorityLevelConfiguration，必需 +- **body**: }}">PriorityLevelConfiguration，必需 - **dryRun**（**查询参数**）：string @@ -606,11 +610,11 @@ POST /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations --> #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK -201 (}}">PriorityLevelConfiguration): Created +201 (}}">PriorityLevelConfiguration): Created -202 (}}">PriorityLevelConfiguration): Accepted +202 (}}">PriorityLevelConfiguration): Accepted 401: Unauthorized @@ -622,13 +626,13 @@ POST /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations #### HTTP 请求 -PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name} +PUT /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name} #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK -201 (}}">PriorityLevelConfiguration): Created +201 (}}">PriorityLevelConfiguration): Created 401: Unauthorized @@ -677,13 +681,13 @@ PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name #### HTTP 请求 -PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status +PUT /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}/status #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK -201 (}}">PriorityLevelConfiguration): Created +201 (}}">PriorityLevelConfiguration): Created 401: Unauthorized @@ -732,7 +736,7 @@ PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name #### HTTP 请求 -PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name} +PATCH /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name} #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK -201 (}}">PriorityLevelConfiguration): Created +201 (}}">PriorityLevelConfiguration): Created 401: Unauthorized @@ -792,7 +796,7 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{na #### HTTP 请求 -PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name}/status +PATCH /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}/status #### 响应 -200 (}}">PriorityLevelConfiguration): OK +200 (}}">PriorityLevelConfiguration): OK -201 (}}">PriorityLevelConfiguration): Created +201 (}}">PriorityLevelConfiguration): Created 401: Unauthorized @@ -852,7 +856,7 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{na #### HTTP 请求 -DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta3/prioritylevelconfigurations/{name} +DELETE /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}