APIResource

APIResource

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

apiVersion: meta/v1

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

APIResource

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

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

APIResourceList

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

FieldDescription
apiVersion
string		APIVersion 定义了对象这种表示形式的带版本模式。 服务器应将已识别的模式转换为最新的内部值，并可以拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
groupVersion *
string		groupVersion 是该 APIResourceList 所属的组和版本。
kind
string		kind 是该对象表示的 REST 资源的字符串值。 服务器可能根据客户端提交的请求端点推断出此值，不能更新。 此值为驼峰命名法。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
resources *
APIResource array		resources 包含资源的名称以及它们是否属于命名空间范围。
最后修改 July 31, 2026 at 3:20 PM PST: [zh-cn]sync api-resource-v1-meta (1d1efd038a)