大网数据广告活动
Kubernetes 部署与运维

APIGroup

· 52CE 我爱测

`import "k8s.io/apimachinery/pkg/apis/meta/v1"`

apiVersion: meta/v1

import "k8s.io/apimachinery/pkg/apis/meta/v1"

APIGroup {#APIGroup}

APIGroup 包含组的名称、支持的版本以及首选版本。

<hr>

<table> <thead><tr><th>字段</th><th>描述</th></tr></thead> <tbody> <tr> <td><code>apiVersion</code><br/><em>string</em></td> <td>

  apiVersion 定义了对象这种表示形式的带版本模式。服务器应将已识别的模式转换为最新的内部值,
  并可以拒绝未识别的值。更多信息:
  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  </td>
</tr>
<tr>
  <td><code>kind</code><br/><em>string</em></td>
  <td>
  
  APIVerver 定义了对象这种表示形式的带版本模式。服务器应将已识别的模式转换为最新的内部值,
  并可以拒绝未识别的值。更多信息:
  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  </td>
</tr>
<tr>
  <td><code>name</code>&nbsp;<strong>*</strong><br/><em>string</em></td>
  <td>
  
  name 是该组的名称。
  </td>
</tr>
<tr>
  <td><code>preferredVersion</code><br/><em><a href="">GroupVersionForDiscovery</a></em></td>
  <td>
  
  preferredVersion 是 API 服务器首选的版本,通常也是存储版本。
  </td>
</tr>
<tr>
  <td><code>serverAddressByClientCIDRs</code><br/><em><a href="">ServerAddressByClientCIDR array</a></em></td>
  <td>
  
  一个由客户端 CIDR 映射到服务器地址的映射表,这些服务器正为该组提供服务。
  这是为了帮助客户端以网络效率最高的方式访问服务器。客户端可以根据其所匹配的 CIDR,
  使用相应的服务器地址。在存在多个匹配项的情况下,客户端应使用前缀最长的那条 CIDR。
  服务器仅返回它认为客户端能够匹配的 CIDR。例如:只有当客户端使用内部 IP 访问服务器时,
  主控节点才会返回内部 IP 段的 CIDR。服务器按顺序查看 `X-Forwarded-For` 头、`X-Real-Ip`
  头或 `request.RemoteAddr` 来获取客户端 IP。
  </td>
</tr>
<tr>
  <td><code>versions</code>&nbsp;<strong>*</strong><br/><em><a href="">GroupVersionForDiscovery array</a></em></td>
  <td>
  
  versions 是该组支持的版本。
  </td>
</tr>

</tbody> </table>

APIGroupList {#APIGroupList}

APIGroupList 是 APIGroup 的列表,用于允许客户端发现 /apis 路径下的 API。

<hr>

<table> <thead><tr><th>字段</th><th>描述</th></tr></thead> <tbody> <tr> <td><code>apiVersion</code><br/><em>string</em></td> <td>

  apiVersion 定义了对象这种表示形式的带版本模式。服务器应将已识别的模式转换为最新的内部值,
  并可以拒绝未识别的值。更多信息:
  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  </td>
</tr>
<tr>
  <td><code>groups</code>&nbsp;<strong>*</strong><br/><em><a href="">APIGroup array</a></em></td>
  <td>
  
  groups 是 APIGroup 的列表。
  </td>
</tr>
<tr>
  <td><code>kind</code><br/><em>string</em></td>
  <td>
  
  kind 是一个字符串值,表示对象代表的 REST 资源。
  服务器可能会根据客户端提交的请求端点来推断此值,不能被更新。驼峰命名法。更多信息:
  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
  </td>
</tr>

</tbody> </table>

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。