Kubernetes PV创建报错：apps/v1版本无PersistentVolume资源映射

错误原因 #

报错核心问题是PersistentVolume不属于apps/v1 API组——这个API组仅适用于Deployment、StatefulSet这类工作负载资源。PersistentVolume属于Kubernetes核心API组，对应的正确apiVersion是v1。

修正后的PV配置文件 #

将pv.yml中的apiVersion字段修改为v1即可，完整内容如下：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: task-pv-volume
  labels:
    type: local
spec:
  storageClassName: manual
  capacity: 
    storage: 2Gi
  accessModes: 
    - ReadWriteOnce
  hostPath:
    path: "/mnt/data"

补充说明 #

之前该YAML能正常执行，大概率是旧版本Kubernetes对API组兼容性更宽松，允许不规范写法。但你当前使用的Kubernetes 1.28（EKS）版本对API组校验更严格，必须使用资源对应的正确apiVersion。

执行修正后的配置：

kubectl apply -f pv.yml

内容的提问来源于stack exchange，提问作者Raghunath Dhara