哪些类型的Kubernetes API组名称包含k8s.io后缀?
Kubernetes API组命名差异与apiVersion格式解析
核心组的简化写法
Kubernetes最初的核心资源(如Pod、Service、Namespace、ConfigMap等)归属于核心组,其正式组名为空字符串。为了简化使用,在清单中指定apiVersion时直接写v1,不需要添加组前缀——这就是你看到单独v1而非core/v1的原因。
命名组的两种格式规范
后续扩展的API组采用域名式命名规则,目的是避免命名冲突,同时明确资源的功能归属,这类组分为两种情况:
- 带官方短名的组:部分早期扩展组(如负责批量任务的
batch.k8s.io)被官方认可了短名batch,因此在apiVersion中可以简写为batch/v1,无需写完整域名后缀。 - 无官方短名的组:较新的功能组(如存储相关的
storage.k8s.io、调度相关的scheduling.k8s.io)没有对应的短名,因此必须在apiVersion中填写完整的组域名+版本号,比如storage.k8s.io/v1、scheduling.k8s.io/v1。
apiVersion填写总结
- 核心资源:直接写版本号,示例:
v1 - 有官方短名的扩展组:短名+版本号,示例:
batch/v1 - 无官方短名的扩展组:完整组域名+版本号,示例:
storage.k8s.io/v1
内容的提问来源于stack exchange,提问作者KyuWoo Choi
相关产品推荐
相关产品推荐

