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> <strong>*</strong><br/><em>string</em></td>
<td>
kind 是该资源的类型(例如 “Foo” 是资源 “foo” 的类型)。
</td>
</tr>
<tr>
<td><code>name</code> <strong>*</strong><br/><em>string</em></td>
<td>
name 是该资源的复数名称。
</td>
</tr>
<tr>
<td><code>namespaced</code> <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> <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> <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> <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> <strong>*</strong><br/><em><a href="">APIResource array</a></em></td>
<td>
resources 包含资源的名称以及它们是否属于命名空间范围。
</td>
</tr>
</tbody> </table>
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
