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


操作


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 项目的其他地方进行。

上次修改时间:2025 年 4 月 9 日太平洋标准时间下午 6:36:更新 v1.32 的 API 参考文档 (a3b579d035)