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),必需

    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”的,它将排在非“类似 kube”版本字符串之上,这些字符串按字典顺序排序。“类似 kube”的版本以“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 为 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

    Map:在合并期间,将保留键 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 (在查询中): 布尔值

    强制

  • 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 (在查询中): 布尔值

    强制

  • pretty (在查询中): string

    pretty

响应

200 (APIService): OK

201 (APIService): 已创建

401: 未授权

delete 删除一个 APIService

HTTP 请求

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

参数

响应

200 (Status): 成功

202 (Status): 已接受

401: 未授权

deletecollection 删除 APIService 的集合

HTTP 请求

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

参数

响应

200 (Status): 成功

401: 未授权

此页面为自动生成。

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

上次修改时间为 2024 年 8 月 28 日下午 6:01 PST: 更新 v1.31 的自动生成 API 参考 (8ba98c79c1)