From c47e53f6fb1e5a63951b81f505b741ebc3e3f037 Mon Sep 17 00:00:00 2001 From: Michael Date: Mon, 4 Jul 2022 21:23:38 +0800 Subject: [PATCH] [zh-cn] resync flow-schema-v1beta2.md --- .../cluster-resources/flow-schema-v1beta2.md | 1120 +++++++++++++++++ 1 file changed, 1120 insertions(+) create mode 100644 content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta2.md 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-v1beta2.md new file mode 100644 index 0000000000..4a8a2fdcdb --- /dev/null +++ b/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta2.md @@ -0,0 +1,1120 @@ +--- +api_metadata: + apiVersion: "flowcontrol.apiserver.k8s.io/v1beta2" + import: "k8s.io/api/flowcontrol/v1beta2" + kind: "FlowSchema" +content_type: "api_reference" +description: "FlowSchema 定义一组流的模式。" +title: "FlowSchema v1beta2" +weight: 7 +--- + + +`apiVersion: flowcontrol.apiserver.k8s.io/v1beta2` + +`import "k8s.io/api/flowcontrol/v1beta2"` + +## FlowSchema {#FlowSchema} + + +FlowSchema 定义一组流的模式。请注意,一个流由属性类似的一组入站 API 请求组成, +用一对字符串进行标识:FlowSchema 的名称和一个 “流区分项”。 + +
+ +- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta2 + +- **kind**: FlowSchema + + +- **metadata** (}}">ObjectMeta) + + `metadata` 是标准的对象元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + +- **spec** (}}">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} + + +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` 根据用户组名称进行匹配。 + + + **GroupSubject 保存组类别主体的详细信息。** + + + + - **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.subjects.user** (UserSubject) + + `user` 根据用户名进行匹配。 + + + **UserSubject 保存用户类别主体的详细信息。** + + - **rules.subjects.user.name** (string),必需 + + `name` 是要匹配的用户名,可使用 `*` 匹配所有用户名。必需。 + + + + - **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} + + +FlowSchemaStatus 表示 FlowSchema 的当前状态。 + +
+ + +- **conditions** ([]FlowSchemaCondition) + + **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} + + +FlowSchemaList 是 FlowSchema 对象的列表。 + +
+ +- **apiVersion**: flowcontrol.apiserver.k8s.io/v1beta2 + +- **kind**: FlowSchemaList + + +- **metadata** (}}">ListMeta) + + `metadata` 是标准的列表元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + +- **items** ([]}}">FlowSchema),必需 + + `items` 是 FlowSchemas 的列表。 + + +## 操作 {#Operations} + +
+ +### `get` 读取指定的 FlowSchema + +#### HTTP 请求 + +GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name} + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +401: Unauthorized + + +### `get` 读取指定 FlowSchema 的状态 + +#### HTTP 请求 + +GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +401: Unauthorized + + +### `list` 列出或监视 FlowSchema 类别的对象 + +#### HTTP 请求 + +GET /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas + + +#### 参数 + +- **allowWatchBookmarks** (**查询参数**): boolean + + }}">allowWatchBookmarks + +- **continue** (**查询参数**): string + + }}">continue + +- **fieldSelector** (**查询参数**): string + + }}">fieldSelector + +- **labelSelector** (**查询参数**): string + + }}">labelSelector + +- **limit** (**查询参数**): integer + + }}">limit + +- **pretty** (**查询参数**): string + + }}">pretty + +- **resourceVersion** (**查询参数**): string + + }}">resourceVersion + +- **resourceVersionMatch** (**查询参数**): string + + }}">resourceVersionMatch + +- **timeoutSeconds** (**查询参数**): integer + + }}">timeoutSeconds + +- **watch** (**查询参数**): boolean + + }}">watch + + +#### 响应 + +200 (}}">FlowSchemaList): OK + +401: Unauthorized + + +### `create` 创建 FlowSchema + +#### HTTP 请求 + +POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas + + +#### 参数 + +- **body**: }}">FlowSchema,必需 + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +201 (}}">FlowSchema): Created + +202 (}}">FlowSchema): Accepted + +401: Unauthorized + + +### `update` 替换指定的 FlowSchema + +#### HTTP 请求 + +PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name} + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **body**: }}">FlowSchema,必需 + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +201 (}}">FlowSchema): Created + +401: Unauthorized + + +### `update` 替换指定的 FlowSchema 的状态 + +#### HTTP 请求 + +PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **body**: }}">FlowSchema,必需 + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +201 (}}">FlowSchema): Created + +401: Unauthorized + + +### `patch` 部分更新指定的 FlowSchema + +#### HTTP 请求 + +PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name} + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **body**: }}">Patch,必需 + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + +- **force** (**查询参数**): boolean + + }}">force + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +201 (}}">FlowSchema): Created + +401: Unauthorized + + +### `patch` 部分更新指定的 FlowSchema 的状态 + +#### HTTP 请求 + +PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **body**: }}">Patch,必需 + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **fieldManager** (**查询参数**): string + + }}">fieldManager + +- **fieldValidation** (**查询参数**): string + + }}">fieldValidation + +- **force** (**查询参数**): boolean + + }}">force + +- **pretty** (**查询参数**): string + + }}">pretty + + +#### 响应 + +200 (}}">FlowSchema): OK + +201 (}}">FlowSchema): Created + +401: Unauthorized + + +### `delete` 删除 FlowSchema + +#### HTTP 请求 + +DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name} + + +#### 参数 + +- **name** (**路径参数**): string,必需 + + FlowSchema 的名称 + +- **body**: }}">DeleteOptions + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **gracePeriodSeconds** (**查询参数**): integer + + }}">gracePeriodSeconds + +- **pretty** (**查询参数**): string + + }}">pretty + +- **propagationPolicy** (**查询参数**): string + + }}">propagationPolicy + + +#### 响应 + +200 (}}">Status): OK + +202 (}}">Status): Accepted + +401: Unauthorized + + +### `deletecollection` 删除 FlowSchema 的集合 + +#### HTTP 请求 + +DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas + + +#### 参数 + +- **body**: }}">DeleteOptions + +- **continue** (**查询参数**): string + + }}">continue + +- **dryRun** (**查询参数**): string + + }}">dryRun + +- **fieldSelector** (**查询参数**): string + + }}">fieldSelector + +- **gracePeriodSeconds** (**查询参数**): integer + + }}">gracePeriodSeconds + +- **labelSelector** (**查询参数**): string + + }}">labelSelector + +- **limit** (**查询参数**): integer + + }}">limit + +- **pretty** (**查询参数**): string + + }}">pretty + +- **propagationPolicy** (**查询参数**): string + + }}">propagationPolicy + +- **resourceVersion** (**查询参数**): string + + }}">resourceVersion + +- **resourceVersionMatch** (**查询参数**): string + + }}">resourceVersionMatch + +- **timeoutSeconds** (**查询参数**): integer + + }}">timeoutSeconds + + +#### 响应 + +200 (}}">Status): OK + +401: Unauthorized