你正在查看的文档所针对的是 Kubernetes 版本： v1.29
Kubernetes v1.29 版本的文档已不再维护。你现在看到的版本来自于一份静态的快照。如需查阅最新文档，请点击 最新版本。
FlowSchema v1beta3
apiVersion: flowcontrol.apiserver.k8s.io/v1beta3
import "k8s.io/api/flowcontrol/v1beta3"
FlowSchema
FlowSchema 定义一组流的模式。请注意，一个流由属性类似的一组入站 API 请求组成， 用一对字符串进行标识：FlowSchema 的名称和一个 “流区分项”。
apiVersion: flowcontrol.apiserver.k8s.io/v1beta3
kind: FlowSchema
metadata (ObjectMeta)
metadata是标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadataspec (FlowSchemaSpec)
spec是 FlowSchema 预期行为的规约。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
status (FlowSchemaStatus)
status是 FlowSchema 的当前状态。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
FlowSchemaSpec
FlowSchemaSpec 描述 FlowSchema 的规约看起来是怎样的。
priorityLevelConfiguration (PriorityLevelConfigurationReference)，必需
priorityLevelConfiguration应引用集群中的 PriorityLevelConfiguration。 如果此应用无法被解析，则忽略此 FlowSchema，并在其状态中将其标记为无效。必需。PriorityLevelConfigurationReference 包含指向正被使用的 “request-priority” 的信息。
priorityLevelConfiguration.name (string)，必需
name是正被引用的优先级配置的名称。必需。
distinguisherMethod (FlowDistinguisherMethod)
distinguisherMethod定义如何为匹配此模式的请求来计算流区分项。nil表示该区分项被禁用，且因此将始终为空字符串。FlowDistinguisherMethod 指定流区分项的方法。
distinguisherMethod.type (string)，必需
type是流区分项的类型。支持的类型为 “ByUser” 和 “ByNamespace”。必需。
matchingPrecedence (int32)
matchingPrecedence用于选择与给定请求匹配的一个 FlowSchema。 选中的 FlowSchema 是某个 MatchingPrecedence 数值最小（我们视其为逻辑上最大）的 FlowSchema。 每个 MatchingPrecedence 值必须在 [1,10000] 的范围内。 请注意，如果未指定优先顺序，则其默认设为 1000。
rules ([]PolicyRulesWithSubjects)
原子性：将在合并期间被替换
rules描述哪些请求将与这个流模式匹配。只有当至少一条规则与请求匹配时， 才视为此 FlowSchema 与该请求匹配。如果字段值为空表，则 FlowSchema 不会与任何请求匹配。PolicyRulesWithSubjects 给出针对 API 服务器请求的一个测试。 该测试将检查发出请求的主体、所请求的动作和要操作的资源。 只有同时满足以下两个条件时，才表示此 PolicyRulesWithSubjects 与请求匹配： (a) 至少一个主体成员与请求匹配且 (b) 至少 resourceRules 或 nonResourceRules 的一个成员与请求匹配。
rules.subjects ([]Subject)，必需
原子性：将在合并期间被替换
subjects 是此规则相关的普通用户、服务账号或组的列表。在这个列表中必须至少有一个成员。 同时包含 system:authenticated 和 system:unauthenticated 用户组的列表会与每个请求匹配。 此字段为必需。
Subject 用来与匹配请求的发起方，请求的发起方由请求身份认证系统识别出来。 有三种方式来匹配一个发起方：按用户、按组或按服务账号。
rules.subjects.kind (string)，必需
kind标示其他字段中的哪个字段必须非空。必需。rules.subjects.group (GroupSubject)
group根据用户组名称进行匹配。rules.subjects.group.name (string)，必需
name 是要匹配的用户组，或使用
*匹配所有用户组。有关一些广为人知的组名，请参阅 https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go。必需。
rules.subjects.serviceAccount (ServiceAccountSubject)
serviceAccount与 ServiceAccount 对象进行匹配。ServiceAccountSubject 保存服务账号类别主体的详细信息。
rules.subjects.serviceAccount.name (string)，必需
name是要匹配的 ServiceAccount 对象的名称，可使用*匹配所有名称。必需。rules.subjects.serviceAccount.namespace (string)，必需
namespace是要匹配的 ServiceAccount 对象的名字空间。必需。
rules.nonResourceRules ([]NonResourcePolicyRule)
原子性：将在合并期间被替换
nonResourceRules是由 NonResourcePolicyRule 对象构成的列表， 根据请求的动作和目标非资源 URL 来识别匹配的请求。NonResourcePolicyRule 是根据请求的动作和目标非资源 URL 来匹配非资源请求的一种规则。 只有满足以下两个条件时，NonResourcePolicyRule 才会匹配一个请求： (a) 至少 verbs 的一个成员与请求匹配且 (b) 至少 nonResourceURLs 的一个成员与请求匹配。
rules.nonResourceRules.nonResourceURLs ([]string)，必需
集合：合并期间保留唯一值
nonResourceURLs是用户有权访问的一组 URL 前缀，不可以为空。 此字段为必需设置的字段。例如：- "/healthz" 是合法的
- "/hea*" 是不合法的
- "/hea" 是合法的但不会与任何项匹配
- "/hea/*" 也不会与任何项匹配
- "/healthz/*" 与所有组件自身的的健康检查路径匹配。
*与所有非资源 URL 匹配。如果存在此字符，则必须是唯一的输入项。 必需。
rules.nonResourceRules.verbs ([]string)，必需
集合：在合并期间保留唯一值
verbs是与动作匹配的列表，不可以为空。*与所有动作匹配。 如果存在此字符，则必须是唯一的输入项。必需。
rules.resourceRules ([]ResourcePolicyRule)
原子性：将在合并期间被替换
resourceRules是 ResourcePolicyRule 对象的列表，根据请求的动作和目标资源识别匹配的请求。resourceRules和nonResourceRules两者必须至少有一个非空。ResourcePolicyRule 是用来匹配资源请求的规则，对请求的动作和目标资源进行测试。 只有满足以下条件时，ResourcePolicyRule 才会与某个资源请求匹配： (a) 至少 verbs 的一个成员与请求的动作匹配， (b) 至少 apiGroups 的一个成员与请求的 API 组匹配， (c) 至少 resources 的一个成员与请求的资源匹配， (d) 要么 (d1) 请求未指定一个名字空间（即，
namespace==""）且 clusterScope 为 true， 要么 (d2) 请求指定了一个名字空间，且至少 namespaces 的一个成员与请求的名字空间匹配。rules.resourceRules.apiGroups ([]string)，必需
集合：合并期间保留唯一值
apiGroups是与 API 组匹配的列表，不可以为空。*表示与所有 API 组匹配。 如果存在此字符，则其必须是唯一的条目。必需。rules.resourceRules.resources ([]string)，必需
集合：合并期间保留唯一值
resources是匹配的资源（即小写和复数）的列表，如果需要的话，还可以包括子资源。 例如 [ "services", "nodes/status" ]。此列表不可以为空。*表示与所有资源匹配。如果存在此字符，则必须是唯一的条目。必需。
rules.resourceRules.verbs ([]string)，必需
集合：合并期间保留唯一值
verbs是匹配的动作的列表，不可以为空。*表示与所有动作匹配。 如果存在此字符，则必须是唯一的条目。必需。rules.resourceRules.clusterScope (boolean)
clusterScope表示是否与未指定名字空间 （出现这种情况的原因是该资源没有名字空间或请求目标面向所有名字空间）的请求匹配。 如果此字段被省略或为 false，则namespaces字段必须包含一个非空的列表。
rules.resourceRules.namespaces ([]string)
集合：合并期间保留唯一值
namespaces是限制匹配的目标的名字空间的列表。 指定一个目标名字空间的请求只会在以下某一个情况满足时进行匹配： (a) 此列表包含该目标名字空间或 (b) 此列表包含*。 请注意，*与所指定的任何名字空间匹配，但不会与未指定 名字空间的请求匹配 （请参阅clusterScope字段）。此列表可以为空，但前提是clusterScope为 true。
FlowSchemaStatus
FlowSchemaStatus 表示 FlowSchema 的当前状态。
conditions ([]FlowSchemaCondition)
补丁策略：根据键 type 合并
Map：合并期间保留根据键 type 保留其唯一值
conditions是 FlowSchema 当前状况的列表。FlowSchemaCondition 描述 FlowSchema 的状况。
conditions.lastTransitionTime (Time)
lastTransitionTime是状况上一次从一个状态转换为另一个状态的时间。Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。 为 time 包的许多函数方法提供了封装器。
conditions.message (string)
message是一条人类可读的消息，表示上一次转换有关的详细信息。conditions.reason (string)
reason是状况上次转换原因的、驼峰格式命名的、唯一的一个词。
conditions.status (string)
status是状况的状态。可以是 True、False、Unknown。必需。conditions.type (string)
type是状况的类型。必需。
FlowSchemaList
FlowSchemaList 是 FlowSchema 对象的列表。
apiVersion: flowcontrol.apiserver.k8s.io/v1beta3
kind: FlowSchemaList
metadata (ListMeta)
metadata是标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadataitems ([]FlowSchema)，必需
items是 FlowSchemas 的列表。
操作
get 读取指定的 FlowSchema
HTTP 请求
GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
参数
name (路径参数): string，必需
FlowSchema 的名称
pretty (查询参数): string
响应
200 (FlowSchema): OK
401: Unauthorized
get 读取指定 FlowSchema 的状态
HTTP 请求
GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status
参数
name (路径参数): string，必需
FlowSchema 的名称
pretty (查询参数): string
响应
200 (FlowSchema): OK
401: Unauthorized
list 列出或监视 FlowSchema 类别的对象
HTTP 请求
GET /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas
参数
allowWatchBookmarks (查询参数): boolean
continue (查询参数): string
fieldSelector (查询参数): string
labelSelector (查询参数): string
limit (查询参数): integer
pretty (查询参数): string
resourceVersion (查询参数): string
resourceVersionMatch (查询参数): string
sendInitialEvents (查询参数): boolean
timeoutSeconds (查询参数): integer
watch (查询参数): boolean
响应
200 (FlowSchemaList): OK
401: Unauthorized
create 创建 FlowSchema
HTTP 请求
POST /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas
参数
body: FlowSchema，必需
dryRun (查询参数): string
fieldManager (查询参数): string
fieldValidation (查询参数): string
pretty (查询参数): string
响应
200 (FlowSchema): OK
201 (FlowSchema): Created
202 (FlowSchema): Accepted
401: Unauthorized
update 替换指定的 FlowSchema
HTTP 请求
PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
参数
name (路径参数): string，必需
FlowSchema 的名称
body: FlowSchema，必需
dryRun (查询参数): string
fieldManager (查询参数): string
fieldValidation (查询参数): string
pretty (查询参数): string
响应
200 (FlowSchema): OK
201 (FlowSchema): Created
401: Unauthorized
update 替换指定的 FlowSchema 的状态
HTTP 请求
PUT /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status
参数
name (路径参数): string，必需
FlowSchema 的名称
body: FlowSchema，必需
dryRun (查询参数): string
fieldManager (查询参数): string
fieldValidation (查询参数): string
pretty (查询参数): string
响应
200 (FlowSchema): OK
201 (FlowSchema): Created
401: Unauthorized
patch 部分更新指定的 FlowSchema
HTTP 请求
PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
参数
name (路径参数): string，必需
FlowSchema 的名称
body: Patch，必需
dryRun (查询参数): string
fieldManager (查询参数): string
fieldValidation (查询参数): string
force (查询参数): boolean
pretty (查询参数): string
响应
200 (FlowSchema): OK
201 (FlowSchema): Created
401: Unauthorized
patch 部分更新指定的 FlowSchema 的状态
HTTP 请求
PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}/status
参数
name (路径参数): string，必需
FlowSchema 的名称
body: Patch，必需
dryRun (查询参数): string
fieldManager (查询参数): string
fieldValidation (查询参数): string
force (查询参数): boolean
pretty (查询参数): string
响应
200 (FlowSchema): OK
201 (FlowSchema): Created
401: Unauthorized
delete 删除 FlowSchema
HTTP 请求
DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas/{name}
参数
name (路径参数): string，必需
FlowSchema 的名称
body: DeleteOptions
dryRun (查询参数): string
gracePeriodSeconds (查询参数): integer
pretty (查询参数): string
propagationPolicy (查询参数): string
响应
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection 删除 FlowSchema 的集合
HTTP 请求
DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta3/flowschemas
参数
body: DeleteOptions
continue (查询参数): string
dryRun (查询参数): string
fieldSelector (查询参数): string
gracePeriodSeconds (查询参数): integer
labelSelector (查询参数): string
limit (查询参数): integer
pretty (查询参数): string
propagationPolicy (查询参数): string
resourceVersion (查询参数): string
resourceVersionMatch (查询参数): string
sendInitialEvents (查询参数): boolean
timeoutSeconds (查询参数): integer
响应
200 (Status): OK
401: Unauthorized
该页面是自动生成的。
如果你打算报告此页面的问题，请在问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。