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

APIResource

· 52CE 我爱测

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

apiVersion: meta/v1

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

APIResource {#APIResource}

APIResource 指定了资源的名称以及该资源是否具有命名空间作用域。

<hr>

<table> <thead><tr><th>Field</th><th>Description</th></tr></thead> <tbody> <tr> <td><code>categories</code><br/><em>string array</em></td> <td>

  categories 是该资源所属的分组资源列表(例如 “all”)。
  </td>
</tr>
<tr>
  <td><code>group</code><br/><em>string</em></td>
  <td>
  
  group 是该资源的首选组。若为空,则表示所属资源列表的组。对于子资源,该值可能不同,例如:"Scale"。
  </td>
</tr>
<tr>
  <td><code>kind</code>&nbsp;<strong>*</strong><br/><em>string</em></td>
  <td>
  
  kind 是该资源的类型(例如 “Foo” 是资源 “foo” 的类型)。
  </td>
</tr>
<tr>
  <td><code>name</code>&nbsp;<strong>*</strong><br/><em>string</em></td>
  <td>
  
  name 是该资源的复数名称。
</td>
</tr>
<tr>
  <td><code>namespaced</code>&nbsp;<strong>*</strong><br/><em>boolean</em></td>
  <td>
  
  namespaced 表示该资源是否具有命名空间作用域。
  </td>
</tr>
<tr>
  <td><code>shortNames</code><br/><em>string array</em></td>
  <td>
  
  shortNames 是该资源建议的短名称列表。
  </td>
</tr>
<tr>
  <td><code>singularName</code>&nbsp;<strong>*</strong><br/><em>string</em></td>
  <td>
  
  singularName 是资源的单数名称。这允许客户端以不透明的方式处理复数和单数形式。
  singularName 更适合用于报告单个条目的状态,在 `kubectl` CLI 界面下单数和复数形式都是被允许的。
  </td>
</tr>
<tr>
  <td><code>storageVersionHash</code><br/><em>string</em></td>
  <td>
    
  存储版本(Storage Version)的哈希值,即该资源在写入数据存储时所转换到的版本。
  该值必须被客户端视为不透明;仅可对该值进行相等性比较。
  这是一项 Alpha 特性,未来可能发生变化或被移除。只有启用了 `StorageVersionHash` 特性门控后,
  apiserver 才会填充此字段。即使该字段升级为正式发布(GA),它也将保持可选。
  </td>
</tr>
<tr>
  <td><code>verbs</code>&nbsp;<strong>*</strong><br/><em>string array</em></td>
  <td>
  
  verbs 是该资源支持的 kube 动词列表(包括
  get、list、watch、create、update、patch、delete、deletecollection 和 proxy)。
  </td>
</tr>
<tr>
  <td><code>version</code><br/><em>string</em></td>
  <td>
  
  version 是该资源的首选版本。若为空,则表示所属资源列表的版本。
  对于子资源,该值可能不同,例如:"v1"(在核心资源的 v1beta1 版本中)。
  </td>
</tr>

</tbody> </table>

APIResourceList {#APIResourceList}

APIResourceList 是 APIResource 的列表,用于公开特定组(group)和版本(version)下支持的资源名称, 以及该资源是否属于命名空间(namespaced)范围。

<hr>

<table> <thead><tr><th>Field</th><th>Description</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>groupVersion</code>&nbsp;<strong>*</strong><br/><em>string</em></td>
  <td>
  
  groupVersion 是该 APIResourceList 所属的组和版本。
  </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>
<tr>
  <td><code>resources</code>&nbsp;<strong>*</strong><br/><em><a href="">APIResource array</a></em></td>
  <td>
  
  resources 包含资源的名称以及它们是否属于命名空间范围。
  </td>
</tr>

</tbody> </table>

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

资料来源与适用范围

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

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

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