第 2 章 APIService [apiregistration.k8s.io/v1]

描述: APIService 代表特定 GroupVersion 的服务器。name 必须是 "version.group"。
类型: 对象

2.1. 规格

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`对象`	APIServiceSpec 包含查找和与服务器通信的信息。仅支持 https，但您可以禁用证书验证。
`status`	`对象`	APIServiceStatus 包含有关 API 服务器的派生信息

2.1.1. .spec

描述

APIServiceSpec 包含查找和与服务器通信的信息。仅支持 https，但您可以禁用证书验证。

类型

object

必填

groupPriorityMinimum
versionPriority

属性	类型	描述
`caBundle`	`字符串`	cabundle 是 PEM 编码的 CA 捆绑包，它将用于验证 API 服务器的 serving 证书。如果未指定，则使用 apiserver 上的系统信任 root。
`group`	`字符串`	group 是这个服务器主机的 API 组名称
`groupPriorityMinimum`	`整数`	GroupPriorityMinimum 是此组至少应该具有的优先级。优先级更高的意味着客户端优先于优先级较低的组。请注意，此组的其他版本可能会指定更高的 GroupPriorityMinimum 值，以便整个组具有更高的优先级。主排序基于 GroupPriorityMinimum，将最高数字排序为最低(10 之前的 20 个)。辅助排序基于对象名称的字母比较。(v1.bar before v1.foo)我们推荐类似：18000 和 PaaSes (OpenShift, Deis)中的内容。
`insecureSkipTLSVerify`	`布尔值`	insecureSkipTLSVerify 在与此服务器通信时禁用 TLS 证书验证。强烈建议不要这样做。您应该改为使用 CABundle。
`service`	`对象`	ServiceReference 包含对 Service.legacy.k8s.io 的引用
`version`	`字符串`	version 是这个服务器主机的 API 版本。例如："v1"
`versionPriority`	`整数`	VersionPriority 控制其组中此 API 版本的顺序。必须大于零。主排序基于 VersionPriority，最高排序为最低值(20 之前的 10 个)。由于它位于组内部，因此数字可能很小，可能位于 10s 中。如果版本优先级相等，版本字符串将用于计算组中的顺序。如果版本字符串为 "kube-like"，它将按字典顺序排序为非类似"kube-like"版本字符串。"类似于kube-like"版本以 "v" 开头，然后跟一个数字（主要版本），然后是字符串 "alpha" 或 "beta" 以及另一个数字（次版本）。它们首先按 GA > beta > alpha 排序（其中 GA 是一个没有后缀的版本，如 beta 或 alpha），然后比较主版本，然后比较次版本。一个排序版本列表示例： v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10。

2.1.2. .spec.service

描述: ServiceReference 包含对 Service.legacy.k8s.io 的引用
类型: object

属性	类型	描述
`name`	`字符串`	name 是服务的名称
`namespace`	`字符串`	namespace 是服务的命名空间
`port`	`整数`	如果指定，托管 Webhook 的服务上的端口。默认为 443，以便向后兼容。`port` 应该是有效的端口号(1-65535，含)。

2.1.3. .status

描述: APIServiceStatus 包含有关 API 服务器的派生信息
类型: object

属性	类型	描述
`conditions`	`array`	apiService 的当前状态。
`conditions[]`	`对象`	APIServiceCondition 描述了特定点上的 APIService 状态

2.1.4. .status.conditions

描述: apiService 的当前状态。
类型: array

2.1.5. .status.conditions[]

描述

APIServiceCondition 描述了特定点上的 APIService 状态

类型

object

必填

type
status

属性	类型	描述
`lastTransitionTime`	`时间`	条件从一个状态转换到另一个状态最后一次的时间。
`message`	`字符串`	人类可读的消息，指示最后一次转换的详细信息。
`reason`	`字符串`	条件最后一次转换的唯一、一词、CamelCase 原因。
`status`	`字符串`	status 是条件的状态。可以是 True, False, Unknown。
`type`	`字符串`	type 是条件的类型。

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

© 2024 Red Hat, Inc.