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（扩展除外）为 18000，PaaS（OpenShift，Deis）建议在 2000s。

  • versionPriority (int32)，必需

    VersionPriority 控制此 API 版本在其组内的排序。必须大于零。主要排序基于 VersionPriority，按数字从高到低排序（20 在 10 之前）。由于它在组内，数字可以很小，可能在 10 左右。如果版本优先级相等，则使用版本字符串计算组内的顺序。如果版本字符串是“kube-like”，它将排在非“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 为 nil，则表示此 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)

    Patch 策略：在键 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)

      条件的上次转换的唯一、一个单词的 CamelCase 原因。

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 PM PST：更新 v1.32 的 API 参考文档 (a3b579d035)