25.4. FlowSchema [flowcontrol.apiserver.k8s.io/v1beta1]
- 描述
- FlowSchema 定义一组流的 schema。请注意,一个流由一组具有类似属性的入站 API 请求组成,由一对字符串标识: FlowSchema 和"flow distinguisher"。
- 类型
-
对象
25.4.1. 规格 复制链接链接已复制到粘贴板!
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| |
|
| FlowSchemaSpec 描述了 FlowSchema 的规格如何样子。 |
|
| FlowSchemaStatus 代表 FlowSchema 的当前状态。 |
25.4.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- FlowSchemaSpec 描述了 FlowSchema 的规格如何样子。
- 类型
-
对象
- 必填
-
priorityLevelConfiguration
-
属性 | 类型 | 描述 |
---|---|---|
|
| FlowDistinguisherMethod 指定流区分器的方法。 |
|
|
|
|
| PriorityLevelConfigurationReference 包含指向正在使用的"request-priority"的信息。 |
|
|
|
|
| PolicyRulesWithSubjects 预加一个应用于 apiserver 请求的测试。测试会考虑发出请求的主题,请求动词,以及要执行操作的资源。只有当一个主题成员与请求匹配,并且(b)至少匹配 resourceRules 或 nonResourceRules 或 nonResourceRules 的一个成员时,此 PolicyRulesWithSubjects 才会匹配请求。 |
25.4.1.2. .spec.distinguisherMethod 复制链接链接已复制到粘贴板!
- 描述
- FlowDistinguisherMethod 指定流区分器的方法。
- 类型
-
对象
- 必填
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
25.4.1.3. .spec.priorityLevelConfiguration 复制链接链接已复制到粘贴板!
- 描述
- PriorityLevelConfigurationReference 包含指向正在使用的"request-priority"的信息。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
25.4.1.4. .spec.rules 复制链接链接已复制到粘贴板!
- 描述
-
规则
描述了哪些请求将与此流模式匹配。只有在至少一个规则成员与请求匹配时,此 FlowSchema 才会匹配请求。如果它是一个空片段,则没有与 FlowSchema 匹配的请求。 - 类型
-
array
25.4.1.5. .spec.rules[] 复制链接链接已复制到粘贴板!
- 描述
- PolicyRulesWithSubjects 预加一个应用于 apiserver 请求的测试。测试会考虑发出请求的主题,请求动词,以及要执行操作的资源。只有当一个主题成员与请求匹配,并且(b)至少匹配 resourceRules 或 nonResourceRules 或 nonResourceRules 的一个成员时,此 PolicyRulesWithSubjects 才会匹配请求。
- 类型
-
对象
- 必填
-
subjects
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
|
| NonResourcePolicyRule 是一个 predicate,它根据其操作动词和目标非资源 URL 匹配非资源请求。只有当(a)至少一个操作动词成员与请求匹配,并且(b)至少一个非ResourceURLs 成员与请求匹配时,NonResourcePolicyRule 才会匹配请求。 |
|
|
|
|
| ResourcePolicyRule 是一个与一些资源请求匹配的 predicate,测试请求的操作动词和目标资源。ResourcePolicyRule 匹配资源请求,且只有:(a)至少一个与请求匹配的操作动词成员匹配,(b)至少一个 apiGroups 成员与请求匹配,(c)至少一个与请求匹配的资源成员,并且(d)至少一个与请求匹配的命名空间成员。 |
|
| subjects 是此规则所关注的普通用户、serviceaccount 或组的列表。这个片段必须至少有一个成员。包括 system:authenticated 和 system:unauthenticated 用户组的片段与每个请求匹配。必需。 |
|
| 主题与请求的原始者匹配,如请求身份验证系统所标识。有三种匹配来源器的方法:按用户、组或服务帐户匹配。 |
25.4.1.6. .spec.rules[].nonResourceRules 复制链接链接已复制到粘贴板!
- 描述
-
nonResourceRules
是 NonResourcePolicyRules 列表,它根据其操作动词和目标非资源 URL 识别匹配的请求。 - 类型
-
array
25.4.1.7. .spec.rules[].nonResourceRules[] 复制链接链接已复制到粘贴板!
- 描述
- NonResourcePolicyRule 是一个 predicate,它根据其操作动词和目标非资源 URL 匹配非资源请求。只有当(a)至少一个操作动词成员与请求匹配,并且(b)至少一个非ResourceURLs 成员与请求匹配时,NonResourcePolicyRule 才会匹配请求。
- 类型
-
对象
- 必填
-
verbs
-
nonResourceURLs
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
|
|
|
25.4.1.8. .spec.rules[].resourceRules 复制链接链接已复制到粘贴板!
- 描述
-
resourceRules
是 ResourcePolicyRules 的片段,它根据其操作动词和目标资源识别匹配的请求。至少一个resourceRules
和nonResourceRules
必须为空。 - 类型
-
array
25.4.1.9. .spec.rules[].resourceRules[] 复制链接链接已复制到粘贴板!
- 描述
- ResourcePolicyRule 是一个与一些资源请求匹配的 predicate,测试请求的操作动词和目标资源。ResourcePolicyRule 匹配资源请求,且只有:(a)至少一个与请求匹配的操作动词成员匹配,(b)至少一个 apiGroups 成员与请求匹配,(c)至少一个与请求匹配的资源成员,并且(d)至少一个与请求匹配的命名空间成员。
- 类型
-
对象
- 必填
-
verbs
-
apiGroups
-
resources
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
|
|
|
|
|
命名空间是限制匹配项的目标命名空间列表。 |
|
|
资源是匹配资源列表(例如,小写和复数)以及子资源(如果需要)。 |
|
|
|
25.4.1.10. .spec.rules[].subjects 复制链接链接已复制到粘贴板!
- 描述
- subjects 是此规则所关注的普通用户、serviceaccount 或组的列表。这个片段必须至少有一个成员。包括 system:authenticated 和 system:unauthenticated 用户组的片段与每个请求匹配。必需。
- 类型
-
array
25.4.1.11. .spec.rules[].subjects[] 复制链接链接已复制到粘贴板!
- 描述
- 主题与请求的原始者匹配,如请求身份验证系统所标识。有三种匹配来源器的方法:按用户、组或服务帐户匹配。
- 类型
-
对象
- 必填
-
kind
-
属性 | 类型 | 描述 |
---|---|---|
|
| GroupSubject 包含 group-kind 主题的详细信息。 |
|
|
|
|
| ServiceAccountSubject 包含 service-account-kind 主题的详细信息。 |
|
| UserSubject 包含 user-kind 主题的详细信息。 |
25.4.1.12. .spec.rules[].subjects[].group 复制链接链接已复制到粘贴板!
- 描述
- GroupSubject 包含 group-kind 主题的详细信息。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| name 是匹配的用户组,或"Demo"以匹配所有用户组。有关一些已知的组名称,请参阅 https://github.com/kubernetes/apiserver/blob/master/pkg/authentication/user/user.go。必需。 |
25.4.1.13. .spec.rules[].subjects[].serviceAccount 复制链接链接已复制到粘贴板!
- 描述
- ServiceAccountSubject 包含 service-account-kind 主题的详细信息。
- 类型
-
对象
- 必填
-
namespace
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
|
|
|
25.4.1.14. .spec.rules[].subjects[].user 复制链接链接已复制到粘贴板!
- 描述
- UserSubject 包含 user-kind 主题的详细信息。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
|
|
25.4.1.15. .status 复制链接链接已复制到粘贴板!
- 描述
- FlowSchemaStatus 代表 FlowSchema 的当前状态。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
|
|
| FlowSchemaCondition 描述 FlowSchema 的条件。 |
25.4.1.16. .status.conditions 复制链接链接已复制到粘贴板!
- 描述
-
条件
是 FlowSchema 的当前状态列表。 - 类型
-
array
25.4.1.17. .status.conditions[] 复制链接链接已复制到粘贴板!
- 描述
- FlowSchemaCondition 描述 FlowSchema 的条件。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| |
|
|
Message 是人类可读的消息,指示最后一次转换的详细信息。 |
|
|
|
|
|
|
|
|
|
25.4.2. API 端点 复制链接链接已复制到粘贴板!
可用的 API 端点如下:
/apis/flowcontrol.apiserver.k8s.io/v1beta1/flowschemas
-
DELETE
:删除流架构的集合 -
GET
: 列出或监视类型 FlowSchema 的对象 -
POST
:创建一个 FlowSchema
-
/apis/flowcontrol.apiserver.k8s.io/v1beta1/watch/flowschemas
-
GET
: 观察对 FlowSchema 列表的各个更改。已弃用:将 'watch' 参数与列表操作一起使用。
-
/apis/flowcontrol.apiserver.k8s.io/v1beta1/flowschemas/{name}
-
DELETE
:删除流架构 -
GET
:读取指定的 FlowSchema -
PATCH
:部分更新指定的流架构 -
PUT
:替换指定的 FlowSchema
-
/apis/flowcontrol.apiserver.k8s.io/v1beta1/watch/flowschemas/{name}
-
GET
: 观察对类型 FlowSchema 的对象的更改。已弃用:使用带有列表操作的 'watch' 参数,而是过滤到带有 'fieldSelector' 参数的单个项目。
-
/apis/flowcontrol.apiserver.k8s.io/v1beta1/flowschemas/{name}/status
-
GET
: 指定 FlowSchema 的读取状态 -
PATCH
:部分更新指定流架构的状态 -
PUT
: 替换指定 FlowSchema 的状态
-
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
DELETE
- 描述
- 删除流架构集合
参数 | 类型 | 描述 |
---|---|---|
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| 弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。 |
|
| 是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
GET
- 描述
- 列出或监视类型 FlowSchema 的对象
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
POST
- 描述
- 创建 FlowSchema
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| 如果 'true',则输出被用户友善。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET
- 描述
- 观察对 FlowSchema 列表的各个更改。已弃用:改为使用 'watch' 参数和列表操作。
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| FlowSchema 的名称 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
DELETE
- 描述
- 删除流架构
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| 应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。 |
|
| 弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。 |
|
| 是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。 |
参数 | 类型 | 描述 |
---|---|---|
|
- HTTP 方法
-
GET
- 描述
- 读取指定的 FlowSchema
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH
- 描述
- 部分更新指定的 FlowSchema
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。 |
|
| 强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
PUT
- 描述
- 替换指定的 FlowSchema
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| FlowSchema 的名称 |
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| 如果 'true',则输出被用户友善。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET
- 描述
- 观察对 kind FlowSchema 的对象的更改。已弃用:使用带有列表操作的 'watch' 参数,而是过滤到带有 'fieldSelector' 参数的单个项目。
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| FlowSchema 的名称 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
GET
- 描述
- 指定 FlowSchema 的读取状态
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH
- 描述
- 指定 FlowSchema 的部分更新状态
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。 |
|
| 强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
PUT
- 描述
- 替换指定 FlowSchema 的状态
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空 |