FlowSchema v1beta2

apiVersion: flowcontrol.apiserver.k8s.io/v1beta2

import "k8s.io/api/flowcontrol/v1beta2"

FlowSchema 定义一组流的模式。请注意，一个流由属性类似的一组入站 API 请求组成， 用一对字符串进行标识：FlowSchema 的名称和一个 “流区分项”。

• apiVersion: flowcontrol.apiserver.k8s.io/v1beta2

• kind: FlowSchema

• metadata ()

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

• spec ()

  spec 是 FlowSchema 预期行为的规约。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

• status ()

  status 是 FlowSchema 的当前状态。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

FlowSchemaSpec 描述 FlowSchema 的规约看起来是怎样的。

• 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，则 字段必须包含一个非空的列表。

    • rules.resourceRules.namespaces ([]string)

      集合：合并期间保留唯一值

      namespaces 是限制匹配的目标的名字空间的列表。 指定一个目标名字空间的请求只会在以下某一个情况满足时进行匹配： (a) 此列表包含该目标名字空间或 (b) 此列表包含 *。 请注意，* 与所指定的任何名字空间匹配，但不会与未指定 名字空间的请求匹配 （请参阅 clusterScope 字段）。此列表可以为空，但前提是 clusterScope 为 true。

FlowSchemaStatus 表示 FlowSchema 的当前状态。

• conditions ([]FlowSchemaCondition)

  Map：合并期间保留根据键 type 保留其唯一值

  conditions 是 FlowSchema 当前状况的列表。

  FlowSchemaCondition 描述 FlowSchema 的状况。

  • conditions.lastTransitionTime (Time)

    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 是 FlowSchema 对象的列表。

• apiVersion: flowcontrol.apiserver.k8s.io/v1beta2

• kind: FlowSchemaList

• metadata ()

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

• items ([])，必需

  items 是 FlowSchemas 的列表。

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

• fieldSelector (查询参数): string

  fieldSelector

• labelSelector (查询参数): string

• limit (查询参数): integer

  limit

• pretty (查询参数): string

• resourceVersion (查询参数): string

  resourceVersion

• resourceVersionMatch (查询参数): string

• watch (查询参数): boolean

  watch

响应

200 (FlowSchemaList): OK

401: Unauthorized

HTTP 请求

POST /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas

参数

• body: FlowSchema，必需

• dryRun (查询参数): string

• fieldManager (查询参数): string

  fieldManager

• fieldValidation (查询参数): string

• pretty (查询参数): string

  pretty

响应

200 (FlowSchema): OK

201 (): 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

• fieldManager (查询参数): string

  fieldManager

• fieldValidation (查询参数): string

• pretty (查询参数): string

  pretty

响应

200 (FlowSchema): OK

201 (): Created

401: Unauthorized

update 替换指定的 FlowSchema 的状态

HTTP 请求

PUT /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status

参数

• name (路径参数): string，必需

  FlowSchema 的名称

• dryRun (查询参数): string

• fieldManager (查询参数): string

  fieldManager

• fieldValidation (查询参数): string

• pretty (查询参数): string

  pretty

响应

200 (FlowSchema): OK

201 (): Created

401: Unauthorized

HTTP 请求

PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}

参数

• name (路径参数): string，必需

  FlowSchema 的名称

• body: ，必需

• dryRun (查询参数): string

  dryRun

• fieldManager (查询参数): string

• fieldValidation (查询参数): string

  fieldValidation

• force (查询参数): boolean

• pretty (查询参数): string

  pretty

响应

200 (FlowSchema): OK

201 (): Created

401: Unauthorized

patch 部分更新指定的 FlowSchema 的状态

HTTP 请求

PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}/status

参数

• name (路径参数): string，必需

  FlowSchema 的名称

• body: ，必需

• dryRun (查询参数): string

  dryRun

• fieldManager (查询参数): string

• fieldValidation (查询参数): string

  fieldValidation

• force (查询参数): boolean

• pretty (查询参数): string

  pretty

响应

200 (FlowSchema): OK

201 (): Created

401: Unauthorized

delete 删除 FlowSchema

HTTP 请求

DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas/{name}

参数

• name (路径参数): string，必需

  FlowSchema 的名称

• body:

• dryRun (查询参数): string

  dryRun

• gracePeriodSeconds (查询参数): integer

• pretty (查询参数): string

  pretty

• propagationPolicy (查询参数): string

响应

200 (): OK

202 (Status): Accepted

401: Unauthorized

HTTP 请求

DELETE /apis/flowcontrol.apiserver.k8s.io/v1beta2/flowschemas

参数

• body: DeleteOptions

• continue (查询参数): string

• dryRun (查询参数): string

  dryRun

• fieldSelector (查询参数): string

• gracePeriodSeconds (查询参数): integer

  gracePeriodSeconds

• labelSelector (查询参数): string

• limit (查询参数): integer

  limit

• pretty (查询参数): string

• propagationPolicy (查询参数): string

  propagationPolicy

• resourceVersion (查询参数): string

• resourceVersionMatch (查询参数): string

  resourceVersionMatch

• timeoutSeconds (查询参数): integer

响应

200 (): OK