OpenShift 文档正在迁移，很快将仅在 docs.redhat.com（所有 Red Hat 产品文档的所在地）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

PriorityLevelConfiguration [flowcontrol.apiserver.k8s.io/v1]

规格

属性 类型 描述

apiVersion

字符串

APIVersion定义了此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

Kind是表示此对象表示的REST资源的字符串值。服务器可以从客户端提交请求的端点推断出这一点。无法更新。使用驼峰式命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

metadata是标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

PriorityLevelConfigurationSpec指定优先级的配置。

status

对象

PriorityLevelConfigurationStatus表示“请求优先级”的当前状态。

.spec

描述

PriorityLevelConfigurationSpec指定优先级的配置。

类型

对象

必需

  • 类型

属性 类型 描述

exempt

对象

ExemptPriorityLevelConfiguration描述了免除请求处理的可配置方面。在强制性免除配置对象中，授权用户可以修改此处的字段值，这与spec中的其余部分不同。

limited

对象

LimitedPriorityLevelConfiguration指定如何处理受限的请求。它解决了两个问题：- 如何限制此优先级的请求？- 应该如何处理超过限制的请求？

类型

字符串

type指示此优先级是否受请求执行限制。值为"Exempt"意味着此优先级的请求不受限制（因此从不排队）并且不会减少提供给其他优先级的容量。值为"Limited"意味着（a）此优先级的请求受限制，并且（b）服务器的某些有限容量专门提供给此优先级。必需。

.spec.exempt

描述

ExemptPriorityLevelConfiguration描述了免除请求处理的可配置方面。在强制性免除配置对象中，授权用户可以修改此处的字段值，这与spec中的其余部分不同。

类型

对象

属性 类型 描述

lendablePercent

整数

lendablePercent规定其他优先级可以借用该级别NominalCL的比例。此字段的值必须在0到100（含）之间，默认为0。其他级别可以从此级别借用的席位数，称为此级别的可借并发限制（LendableCL），定义如下。

LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )

nominalConcurrencyShares

整数

nominalConcurrencyShares (NCS) 有助于计算此级别的名义并发限制 (NominalCL)。这是为此优先级名义保留的执行席位数。这不会限制从此优先级的调度，但会通过借用机制影响其他优先级。服务器的并发限制 (ServerCL) 按比例分配给所有优先级，比例与其 NCS 值成比例。

NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)

更大的数字意味着更大的名义并发限制，但会以其他每个优先级为代价。此字段的默认值为零。

.spec.limited

描述

LimitedPriorityLevelConfiguration指定如何处理受限的请求。它解决了两个问题：- 如何限制此优先级的请求？- 应该如何处理超过限制的请求？

类型

对象

属性 类型 描述

borrowingLimitPercent

整数

如果存在borrowingLimitPercent，则配置此优先级可以从其他优先级借用多少席位的限制。此限制称为此级别的借用并发限制 (BorrowingCL)，是对此级别在任何时间点可以借用的席位总数的限制。此字段包含该限制与其级别名义并发限制的比率。当此字段非空时，它必须包含一个非负整数，并且限制计算如下。

BorrowingCL(i) = round( NominalCL(i) * borrowingLimitPercent(i)/100.0 )

此字段的值可以大于100，这意味着此优先级可以借用的席位数大于其自身的名义并发限制 (NominalCL)。当此字段保留为nil时，限制实际上是无限的。

lendablePercent

整数

lendablePercent规定其他优先级可以借用该级别NominalCL的比例。此字段的值必须在0到100（含）之间，默认为0。其他级别可以从此级别借用的席位数，称为此级别的可借并发限制（LendableCL），定义如下。

LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )

limitResponse

对象

LimitResponse定义如何处理现在无法执行的请求。

nominalConcurrencyShares

整数

nominalConcurrencyShares (NCS) 有助于计算此级别的名义并发限制 (NominalCL)。这是在此优先级可用的执行席位数。这用于从此优先级分派的请求以及从此优先级借用席位的其他优先级分派的请求。服务器的并发限制 (ServerCL) 按比例分配给受限优先级，比例与其 NCS 值成比例。

NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)

更大的数字意味着更大的名义并发限制，但会以其他每个优先级为代价。

如果未指定，则此字段默认为30。

将此字段设置为零支持为此优先级构建一个“监狱”，用于保存某些请求。

.spec.limited.limitResponse

描述

LimitResponse定义如何处理现在无法执行的请求。

类型

对象

必需

  • 类型

属性 类型 描述

queuing

对象

QueuingConfiguration保存排队的配置参数。

类型

字符串

type 为 "Queue" 或 "Reject"。"Queue" 表示到达时无法执行的请求将保留在队列中，直到可以执行或达到排队限制。"Reject" 表示到达时无法执行的请求将被拒绝。必填。

.spec.limited.limitResponse.queuing

描述

QueuingConfiguration保存排队的配置参数。

类型

对象

属性 类型 描述

handSize

整数

handSize 是一个小的正数，用于配置将请求混洗分片到队列中。当在此优先级级别入队请求时，请求的流标识符（字符串对）将被哈希，哈希值用于混洗队列列表并发出一组指定大小的队列。请求将放入该组中最短的队列之一。handSize 必须不大于 queues，并且应该显著小于 queues（这样少数几个繁重的流不会饱和大多数队列）。有关设置此字段的更详细指导，请参阅面向用户的文档。此字段的默认值为 8。

queueLengthLimit

整数

queueLengthLimit 是允许在给定优先级级别的队列中同时等待的请求最大数量；超过此数量的请求将被拒绝。此值必须为正数。如果未指定，则默认为 50。

queues

整数

queues 是此优先级级别的队列数。队列在每个 apiserver 上独立存在。该值必须为正数。将其设置为 1 会有效地阻止混洗分片，从而使关联的流模式的区分方法变得无关紧要。此字段的默认值为 64。

.status

描述

PriorityLevelConfigurationStatus表示“请求优先级”的当前状态。

类型

对象

属性 类型 描述

conditions

数组

conditions 是“请求优先级”的当前状态。

conditions[]

对象

PriorityLevelConfigurationCondition 定义优先级的状态。

.status.conditions

描述

conditions 是“请求优先级”的当前状态。

类型

数组

.status.conditions[]

描述

PriorityLevelConfigurationCondition 定义优先级的状态。

类型

对象

属性 类型 描述

lastTransitionTime

时间

lastTransitionTime 是条件从一种状态转换到另一种状态的最后时间。

message

字符串

message 是一个易于理解的消息，指示有关最后转换的详细信息。

reason

字符串

reason 是条件最后转换的唯一、单字、驼峰命名法的原因。

status

字符串

status 是条件的状态。可以是 True、False、Unknown。必填。

类型

字符串

type 是条件的类型。必填。

API 端点

提供以下 API 端点

  • /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations

    • DELETE：删除 PriorityLevelConfiguration 集合

    • GET：列出或监视 PriorityLevelConfiguration 对象

    • POST：创建 PriorityLevelConfiguration

  • /apis/flowcontrol.apiserver.k8s.io/v1/watch/prioritylevelconfigurations

    • GET：监视 PriorityLevelConfiguration 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

  • /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}

    • DELETE：删除 PriorityLevelConfiguration

    • GET：读取指定的 PriorityLevelConfiguration

    • PATCH：部分更新指定的 PriorityLevelConfiguration

    • PUT：替换指定的 PriorityLevelConfiguration

  • /apis/flowcontrol.apiserver.k8s.io/v1/watch/prioritylevelconfigurations/{name}

    • GET：监视 PriorityLevelConfiguration 对象的更改。已弃用：请改用列表操作中的“watch”参数，并使用“fieldSelector”参数将其过滤为单个项目。

  • /apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}/status

    • GET：读取指定的 PriorityLevelConfiguration 的状态

    • PATCH：部分更新指定的 PriorityLevelConfiguration 的状态

    • PUT：替换指定的 PriorityLevelConfiguration 的状态

/apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations

HTTP 方法

DELETE

描述

删除 PriorityLevelConfiguration 集合

表 1. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段
表 2. HTTP 响应
HTTP 代码 响应体

200 - OK

Status 模式

401 - 未授权

空
HTTP 方法

GET

描述

列出或监视 PriorityLevelConfiguration 对象

表 3. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfigurationList 模式

401 - 未授权

空
HTTP 方法

POST

描述

创建 PriorityLevelConfiguration

表 4. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。
表 5. 主体参数
参数 类型 描述

主体

PriorityLevelConfiguration 模式
表 6. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

201 - 已创建

PriorityLevelConfiguration 模式

202 - 已接受

PriorityLevelConfiguration 模式

401 - 未授权

空

/apis/flowcontrol.apiserver.k8s.io/v1/watch/prioritylevelconfigurations

HTTP 方法

GET

描述

监视 PriorityLevelConfiguration 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

表 7. HTTP 响应
HTTP 代码 响应体

200 - OK

WatchEvent 模式

401 - 未授权

空

/apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}

表 8. 全局路径参数
参数 类型 描述

name

字符串

PriorityLevelConfiguration 的名称
HTTP 方法

DELETE

描述

删除 PriorityLevelConfiguration

表 9. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段
表 10. HTTP 响应
HTTP 代码 响应体

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

空
HTTP 方法

GET

描述

读取指定的 PriorityLevelConfiguration

表 11. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定的 PriorityLevelConfiguration

表 12. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。
表 13. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

201 - 已创建

PriorityLevelConfiguration 模式

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定的 PriorityLevelConfiguration

表 14. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。
表 15. 主体参数
参数 类型 描述

主体

PriorityLevelConfiguration 模式
表 16. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

201 - 已创建

PriorityLevelConfiguration 模式

401 - 未授权

空

/apis/flowcontrol.apiserver.k8s.io/v1/watch/prioritylevelconfigurations/{name}

表 17. 全局路径参数
参数 类型 描述

name

字符串

PriorityLevelConfiguration 的名称
HTTP 方法

GET

描述

监视 PriorityLevelConfiguration 对象的更改。已弃用：请改用列表操作中的“watch”参数，并使用“fieldSelector”参数将其过滤为单个项目。

表 18. HTTP 响应
HTTP 代码 响应体

200 - OK

WatchEvent 模式

401 - 未授权

空

/apis/flowcontrol.apiserver.k8s.io/v1/prioritylevelconfigurations/{name}/status

表 19. 全局路径参数
参数 类型 描述

name

字符串

PriorityLevelConfiguration 的名称
HTTP 方法

GET

描述

读取指定的 PriorityLevelConfiguration 的状态

表 20. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定的 PriorityLevelConfiguration 的状态

表 21. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。
表 22. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

201 - 已创建

PriorityLevelConfiguration 模式

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定的 PriorityLevelConfiguration 的状态

表 23. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使用 BadRequest 错误使请求失败。从服务器返回的错误将包含遇到的所有未知和重复字段。
表 24. 主体参数
参数 类型 描述

主体

PriorityLevelConfiguration 模式
表 25. HTTP 响应
HTTP 代码 响应体

200 - OK

PriorityLevelConfiguration 模式

201 - 已创建

PriorityLevelConfiguration 模式

401 - 未授权

空