APIService
apiVersion: apiregistration.k8s.io/v1
import "k8s.io/kube-aggregator/pkg/apis/apiregistration/v1"
APIService
APIService 表示特定 GroupVersion 的服务器。名称必须为 "version.group"。
apiVersion: apiregistration.k8s.io/v1
kind: APIService
metadata (ObjectMeta)
标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (APIServiceSpec)
Spec 包含用于查找和与服务器通信的信息
status (APIServiceStatus)
Status 包含有关 API 服务器的派生信息
APIServiceSpec
APIServiceSpec 包含用于查找和与服务器通信的信息。只支持 HTTPS,但你可以禁用证书验证。
groupPriorityMinimum (int32), 必需
GroupPriorityMinimum 是此组应至少具有的优先级。优先级越高,表示客户端越倾向于选择此组而不是优先级较低的组。请注意,此组的其他版本可能会指定更高的 GroupPriorityMinimum 值,从而使整个组获得更高的优先级。主要排序基于 GroupPriorityMinimum,按从高到低排序(20 在 10 之前)。次要排序基于对象名称的字母比较。(v1.bar 在 v1.foo 之前)我们建议如下:*.k8s.io(extensions 除外)为 18000,PaaS(OpenShift、Deis)建议在 2000 左右。
versionPriority (int32), 必需
VersionPriority 控制此 API 版本在其组内的排序。必须大于零。主要排序基于 VersionPriority,按从高到低排序(20 在 10 之前)。由于它在一个组内,因此数字可以很小,可能在 10 左右。如果版本优先级相等,则版本字符串将用于计算组内的顺序。如果版本字符串是“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。
caBundle ([]byte)
原子性:在合并期间将被替换
CABundle 是 PEM 编码的 CA 捆绑包,将用于验证 API 服务器的服务证书。如果未指定,则使用 API 服务器上的系统信任根。
group (string)
Group 是此服务器托管的 API 组名称
insecureSkipTLSVerify (boolean)
InsecureSkipTLSVerify 在与此服务器通信时禁用 TLS 证书验证。强烈不建议这样做。您应该改用 CABundle。
service (ServiceReference)
Service 是对此 API 服务器服务的引用。它必须通过端口 443 进行通信。如果 Service 为 nil,则表示 API 组版本的处理在此服务器上本地处理。调用将简单地委托给正常的处理程序链以完成。
ServiceReference 包含对 Service.legacy.k8s.io 的引用
service.name (string)
Name 是服务的名称
service.namespace (string)
Namespace 是服务的命名空间
service.port (int32)
如果指定,则为托管 webhook 的服务端口。为向后兼容,默认为 443。`port` 应为有效的端口号(包括 1-65535)。
version (string)
Version 是此服务器托管的 API 版本。例如,“v1”
APIServiceStatus
APIServiceStatus 包含有关 API 服务器的派生信息
conditions ([]APIServiceCondition)
补丁策略:按键
type
合并映射:合并时将保留键类型上的唯一值
apiService 的当前服务状态。
APIServiceCondition 描述了 APIService 在特定时间点的状态
conditions.status (string),必需
Status 是条件的状态。可以是 True、False、Unknown。
conditions.type (string),必需
Type 是条件的类型。
conditions.lastTransitionTime (Time)
条件上次从一种状态转换到另一种状态的时间。
Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。
conditions.message (string)
人类可读的消息,指示上次转换的详细信息。
conditions.reason (string)
条件上次转换的唯一、单字、驼峰式原因。
APIServiceList
APIServiceList 是 APIService 对象的列表。
apiVersion: apiregistration.k8s.io/v1
kind: APIServiceList
metadata (ListMeta)
标准列表元数据。更多信息请参见:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]APIService), 必需
Items 是 APIService 的列表
操作
get
读取指定的 APIService
HTTP 请求
GET /apis/apiregistration.k8s.io/v1/apiservices/{name}
参数
name (在路径中): string,必填
APIService 的名称
pretty (在查询中): string
响应
200 (APIService): OK
401: 未授权
get
读取指定的 APIService 的状态
HTTP 请求
GET /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
参数
name (在路径中): string,必填
APIService 的名称
pretty (在查询中): string
响应
200 (APIService): OK
401: 未授权
list
列出或监视类型为 APIService 的对象
HTTP 请求
GET /apis/apiregistration.k8s.io/v1/apiservices
参数
allowWatchBookmarks (在查询中): boolean
continue (在查询中): string
fieldSelector (在查询中): string
labelSelector (在查询中): string
limit (在查询中): integer
pretty (在查询中): string
resourceVersion (在查询中): string
resourceVersionMatch (在查询中): string
sendInitialEvents (在查询中): boolean
timeoutSeconds (在查询中): integer
watch (在查询中): boolean
响应
200 (APIServiceList): OK
401: 未授权
create
创建一个 APIService
HTTP 请求
POST /apis/apiregistration.k8s.io/v1/apiservices
参数
body: APIService, 必需
dryRun (在查询中): string
fieldManager (在查询中): string
fieldValidation (在查询中): string
pretty (在查询中): string
响应
200 (APIService): OK
201 (APIService): 已创建
202 (APIService): 已接受
401: 未授权
update
替换指定的 APIService
HTTP 请求
PUT /apis/apiregistration.k8s.io/v1/apiservices/{name}
参数
name (在路径中): string,必填
APIService 的名称
body: APIService, 必需
dryRun (在查询中): string
fieldManager (在查询中): string
fieldValidation (在查询中): string
pretty (在查询中): string
响应
200 (APIService): OK
201 (APIService): 已创建
401: 未授权
update
替换指定的 APIService 的状态
HTTP 请求
PUT /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
参数
name (在路径中): string,必填
APIService 的名称
body: APIService, 必需
dryRun (在查询中): string
fieldManager (在查询中): string
fieldValidation (在查询中): string
pretty (在查询中): string
响应
200 (APIService): OK
201 (APIService): 已创建
401: 未授权
patch
部分更新指定的 APIService
HTTP 请求
PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}
参数
name (在路径中): string,必填
APIService 的名称
body: Patch,必需
dryRun (在查询中): string
fieldManager (在查询中): string
fieldValidation (在查询中): string
force (在查询中): boolean
pretty (在查询中): string
响应
200 (APIService): OK
201 (APIService): 已创建
401: 未授权
patch
部分更新指定的 APIService 的状态
HTTP 请求
PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
参数
name (在路径中): string,必填
APIService 的名称
body: Patch,必需
dryRun (在查询中): string
fieldManager (在查询中): string
fieldValidation (在查询中): string
force (在查询中): boolean
pretty (在查询中): string
响应
200 (APIService): OK
201 (APIService): 已创建
401: 未授权
delete
删除一个 APIService
HTTP 请求
DELETE /apis/apiregistration.k8s.io/v1/apiservices/{name}
参数
name (在路径中): string,必填
APIService 的名称
body: DeleteOptions
dryRun (在查询中): string
gracePeriodSeconds (在查询中): integer
ignoreStoreReadErrorWithClusterBreakingPotential (在查询中): boolean
pretty (在查询中): string
propagationPolicy (在查询中): string
响应
200 (Status): OK
202 (Status): 已接受
401: 未授权
deletecollection
删除 APIService 集合
HTTP 请求
DELETE /apis/apiregistration.k8s.io/v1/apiservices
参数
body: DeleteOptions
continue (在查询中): string
dryRun (在查询中): string
fieldSelector (在查询中): string
gracePeriodSeconds (在查询中): integer
ignoreStoreReadErrorWithClusterBreakingPotential (在查询中): boolean
labelSelector (在查询中): string
limit (在查询中): integer
pretty (在查询中): string
propagationPolicy (在查询中): string
resourceVersion (在查询中): string
resourceVersionMatch (在查询中): string
sendInitialEvents (在查询中): boolean
timeoutSeconds (在查询中): integer
响应
200 (Status): OK
401: 未授权
本页面是自动生成的。
如果你打算报告此页面存在的问题,请在问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。