APIService

APIService 代表特定 GroupVersion 的服务器。

apiVersion: apiregistration.k8s.io/v1

import "k8s.io/kube-aggregator/pkg/apis/apiregistration/v1"

APIService

APIService 代表特定 GroupVersion 的服务器。名称必须为“version.group”。

APIServiceSpec

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

  • groupPriorityMinimum (int32), 必需

    GroupPriorityMininum 是此组应具有的最低优先级。优先级越高表示客户端更喜欢该组而不是优先级较低的组。请注意，此组的其他版本可能会指定更高的 GroupPriorityMininum 值，以便整个组获得更高的优先级。主要排序基于 GroupPriorityMinimum，从最高数字到最低数字排序（20 在 10 之前）。次要排序基于对象的名称的字母顺序比较。（v1.bar 在 v1.foo 之前）我们建议使用以下内容：*.k8s.io（扩展除外）为 18000，PaaSes（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 服务器的服务证书。如果未指定，则使用 apiserver 上的系统信任根。

  • group (string)

    Group 是此服务器托管的 API 组名称

  • insecureSkipTLSVerify (boolean)

    InsecureSkipTLSVerify 在与该服务器通信时禁用 TLS 证书验证。强烈建议不要这样做。您应该使用 CABundle 代替。

  • service (ServiceReference)

    Service 是对该 API 服务器服务的引用。它必须在端口 443 上进行通信。如果 Service 为空，则表示对 API groupversion 的处理是在此服务器上本地处理的。该调用将简单地委托给正常的处理程序链以完成。

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

操作

get 读取指定的 APIService

HTTP 请求

GET /apis/apiregistration.k8s.io/v1/apiservices/{name}

参数

  • name (在路径中): string, 必需

    APIService 的名称

  • pretty (在查询中): string

    pretty

响应

200 (APIService): OK

401: 未经授权

get 读取指定 APIService 的状态

HTTP 请求

GET /apis/apiregistration.k8s.io/v1/apiservices/{name}/status

参数

  • name (在路径中): string, 必需

    APIService 的名称

  • pretty (在查询中): string

    pretty

响应

200 (APIService): OK

401: 未经授权

list 列出或观察 APIService 类型的对象

HTTP 请求

GET /apis/apiregistration.k8s.io/v1/apiservices

参数

响应

200 (APIServiceList): OK

401: 未经授权

create 创建一个 APIService

HTTP 请求

POST /apis/apiregistration.k8s.io/v1/apiservices

参数

响应

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

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

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

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (APIService): OK

201 (APIService): 已创建

401: 未经授权

patch 部分更新指定的 APIService

HTTP 请求

PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}

参数

  • name (在路径中): string, 必需

    APIService 的名称

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

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

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (APIService): OK

201 (APIService): 已创建

401: 未经授权

delete 删除一个 APIService

HTTP 请求

DELETE /apis/apiregistration.k8s.io/v1/apiservices/{name}

参数

响应

200 (Status): OK

202 (Status): 已接受

401: 未经授权

deletecollection 删除 APIService 集合

HTTP 请求

DELETE /apis/apiregistration.k8s.io/v1/apiservices

参数

响应

200 (Status): OK

401: 未经授权

此页面是自动生成的。

如果您要报告此页面的问题，请在您的问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间：2023 年 12 月 25 日，太平洋标准时间上午 8:23：代码审查反馈 (55cfdc24fb)