×

规范

属性 类型 描述

apiVersion

字符串

APIVersion 定义了此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值,并可能拒绝无法识别的值。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

Kind 是一个字符串值,表示此对象表示的 REST 资源。服务器可以从此客户端提交请求的端点推断出这一点。不能更新。使用驼峰命名法。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

PersistentVolumeSpec 是持久卷的规范。

status

对象

PersistentVolumeStatus 是持久卷的当前状态。

.spec

描述

PersistentVolumeSpec 是持久卷的规范。

类型

对象

属性 类型 描述

accessModes

数组 (字符串)

accessModes 包含卷可以挂载的所有方式。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#access-modes

awsElasticBlockStore

对象

表示 AWS 中的持久磁盘资源。

在挂载到容器之前必须存在 AWS EBS 磁盘。磁盘还必须与 kubelet 位于同一个 AWS 区域。AWS EBS 磁盘只能一次以读写方式挂载。AWS EBS 卷支持所有权管理和 SELinux 重新标记。

azureDisk

对象

AzureDisk 表示主机上的 Azure 数据磁盘挂载以及到 Pod 的绑定挂载。

azureFile

对象

AzureFile 表示主机上的 Azure 文件服务挂载以及到 Pod 的绑定挂载。

capacity

对象 (Quantity)

capacity 是持久卷的资源和容量的描述。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#capacity

cephfs

对象

表示持续 Pod 寿命的 Ceph 文件系统挂载。Cephfs 卷不支持所有权管理或 SELinux 重新标记。

cinder

对象

表示 Openstack 中的 cinder 卷资源。在挂载到容器之前必须存在 Cinder 卷。该卷还必须与 kubelet 位于同一区域。Cinder 卷支持所有权管理和 SELinux 重新标记。

claimRef

对象

ObjectReference 包含足够的信息,可让您检查或修改引用的对象。

csi

对象

表示由外部 CSI 卷驱动程序管理的存储(测试功能)

fc

对象

表示光纤通道卷。光纤通道卷只能以读写方式挂载一次。光纤通道卷支持所有权管理和 SELinux 重新标记。

flexVolume

对象

FlexPersistentVolumeSource 表示使用基于 exec 的插件进行预配/附加的通用持久卷资源。

flocker

对象

表示由 Flocker 代理挂载的 Flocker 卷。datasetName 和 datasetUUID 中只有一个应该设置。Flocker 卷不支持所有权管理或 SELinux 重新标记。

gcePersistentDisk

对象

表示 Google Compute Engine 中的持久磁盘资源。

必须在挂载到容器之前存在 GCE PD。磁盘还必须与 kubelet 位于同一 GCE 项目和区域中。GCE PD 只能以读写方式挂载一次或以只读方式挂载多次。GCE PD 支持所有权管理和 SELinux 重新标记。

glusterfs

对象

表示持续整个 Pod 生命周期 的 Glusterfs 挂载。Glusterfs 卷不支持所有权管理或 SELinux 重新标记。

hostPath

对象

表示映射到 Pod 的主机路径。主机路径卷不支持所有权管理或 SELinux 重新标记。

iscsi

对象

ISCSIPersistentVolumeSource 表示一个 iSCSI 磁盘。iSCSI 卷只能以读写方式挂载一次。iSCSI 卷支持所有权管理和 SELinux 重新标记。

local

对象

Local 表示具有节点亲和性的直接连接存储(测试功能)

mountOptions

数组 (字符串)

mountOptions 是挂载选项的列表,例如 ["ro", "soft"]。未经验证 - 如果一个选项无效,挂载将简单地失败。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes/#mount-options

nfs

对象

表示持续整个 Pod 生命周期 的 NFS 挂载。NFS 卷不支持所有权管理或 SELinux 重新标记。

nodeAffinity

对象

VolumeNodeAffinity 定义了限制此卷可以从中访问的节点的约束。

persistentVolumeReclaimPolicy

字符串

persistentVolumeReclaimPolicy 定义了从其声明中释放持久卷时会发生的情况。有效选项包括 Retain(手动创建的 PersistentVolume 的默认值)、Delete(动态预配的 PersistentVolume 的默认值)和 Recycle(已弃用)。Recycle 必须由此 PersistentVolume 的底层卷插件支持。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#reclaiming

可能的枚举值:- "Delete" 表示在从其声明中释放时,卷将从 Kubernetes 中删除。卷插件必须支持删除。- "Recycle" 表示在从其声明中释放时,卷将被回收回未绑定持久卷的池中。卷插件必须支持回收。- "Retain" 表示卷将保留在其当前阶段(已释放),以便管理员手动回收。默认策略是 Retain。

photonPersistentDisk

对象

表示 Photon Controller 持久磁盘资源。

portworxVolume

对象

PortworxVolumeSource 表示 Portworx 卷资源。

quobyte

对象

表示持续整个 Pod 生命周期 的 Quobyte 挂载。Quobyte 卷不支持所有权管理或 SELinux 重新标记。

rbd

对象

表示持续整个 Pod 生命周期 的 Rados 块设备挂载。RBD 卷支持所有权管理和 SELinux 重新标记。

scaleIO

对象

ScaleIOPersistentVolumeSource 表示持久性 ScaleIO 卷

storageClassName

字符串

storageClassName 是此持久卷所属的 StorageClass 的名称。空值表示此卷不属于任何 StorageClass。

storageos

对象

表示 StorageOS 持久卷资源。

volumeAttributesClassName

字符串

此持久卷所属的 VolumeAttributesClass 的名称。不允许为空值。当此字段未设置时,表示此卷不属于任何 VolumeAttributesClass。此字段是可变的,可以在卷成功更新到新类后由 CSI 驱动程序更改。对于未绑定的 PersistentVolume,在绑定过程中,volumeAttributesClassName 将与未绑定的 PersistentVolumeClaims 匹配。这是一个 alpha 字段,需要启用 VolumeAttributesClass 功能。

volumeMode

字符串

volumeMode 定义卷是否打算与已格式化的文件系统一起使用或保持原始块状态。如果未包含在规范中,则隐含 Filesystem 值。

可能的枚举值:- "Block" 表示卷不会使用文件系统格式化,并将保留为原始块设备。- "Filesystem" 表示卷将使用文件系统进行格式化或已格式化。

vsphereVolume

对象

表示 vSphere 卷资源。

.spec.awsElasticBlockStore

描述

表示 AWS 中的持久磁盘资源。

在挂载到容器之前必须存在 AWS EBS 磁盘。磁盘还必须与 kubelet 位于同一个 AWS 区域。AWS EBS 磁盘只能一次以读写方式挂载。AWS EBS 卷支持所有权管理和 SELinux 重新标记。

类型

对象

必需
  • volumeID

属性 类型 描述

fsType

字符串

fsType 是要挂载的卷的文件系统类型。提示:确保主机操作系统支持文件系统类型。示例:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore

partition

整数

partition 是要挂载的卷中的分区。如果省略,则默认为按卷名挂载。示例:对于卷 /dev/sda1,您将分区指定为“1”。类似地,/dev/sda 的卷分区为“0”(或者您可以保留该属性为空)。

readOnly

布尔值

readOnly 值 true 将强制 VolumeMounts 中的 readOnly 设置。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore

volumeID

字符串

volumeID 是 AWS(Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore

.spec.azureDisk

描述

AzureDisk 表示主机上的 Azure 数据磁盘挂载以及到 Pod 的绑定挂载。

类型

对象

必需
  • diskName

  • diskURI

属性 类型 描述

cachingMode

字符串

cachingMode 是主机缓存模式:无、只读、读写。

可能的枚举值:- "None" - "ReadOnly" - "ReadWrite"

diskName

字符串

diskName 是 blob 存储中数据磁盘的名称

diskURI

字符串

diskURI 是 blob 存储中数据磁盘的 URI

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。

kind

字符串

kind 预期值为 Shared:每个存储帐户多个 blob 磁盘 Dedicated:每个存储帐户单个 blob 磁盘 Managed:azure 托管数据磁盘(仅在托管可用性集中)。默认为 shared

可能的枚举值:- "Dedicated" - "Managed" - "Shared"

readOnly

布尔值

readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

.spec.azureFile

描述

AzureFile 表示主机上的 Azure 文件服务挂载以及到 Pod 的绑定挂载。

类型

对象

必需
  • secretName

  • shareName

属性 类型 描述

readOnly

布尔值

readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

secretName

字符串

secretName 是包含 Azure 存储帐户名称和密钥的密钥的名称

secretNamespace

字符串

secretNamespace 是包含 Azure 存储帐户名称和密钥的密钥的命名空间,默认为与 Pod 相同

shareName

字符串

shareName 是 azure 共享名称

.spec.cephfs

描述

表示持续 Pod 寿命的 Ceph 文件系统挂载。Cephfs 卷不支持所有权管理或 SELinux 重新标记。

类型

对象

必需
  • monitors

属性 类型 描述

monitors

数组 (字符串)

monitors 是必需的:Monitors 是 Ceph monitors 的集合 更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

字符串

path 是可选的:用作已挂载的根目录,而不是完整的 Ceph 树,默认为 /

readOnly

布尔值

readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

字符串

secretFile 可选:SecretFile 是用户密钥环的路径,默认为 /etc/ceph/user.secret。更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

user

字符串

user 可选:User 是 rados 用户名,默认为 admin。更多信息:https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

.spec.cephfs.secretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.cinder

描述

表示 Openstack 中的 cinder 卷资源。在挂载到容器之前必须存在 Cinder 卷。该卷还必须与 kubelet 位于同一区域。Cinder 卷支持所有权管理和 SELinux 重新标记。

类型

对象

必需
  • volumeID

属性 类型 描述

fsType

字符串

fsType 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

布尔值

readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。更多信息:https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

volumeID

字符串

volumeID 用于在 cinder 中标识卷。更多信息:https://examples.k8s.io/mysql-cinder-pd/README.md

.spec.cinder.secretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.claimRef

描述

ObjectReference 包含足够的信息,可让您检查或修改引用的对象。

类型

对象

属性 类型 描述

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而不是整个对象,则此字符串应包含有效的 JSON/Go 字段访问语句,例如 desiredState.manifest.containers[2]。例如,如果对象引用指向 Pod 中的容器,则其值将类似于:“spec.containers{name}”(其中“name”指的是触发事件的容器的名称)或者如果没有指定容器名称,则为“spec.containers[2]”(此 Pod 中索引为 2 的容器)。选择此语法只是为了有一种明确定义的方式来引用对象的一部分。

kind

字符串

引用的 Kind。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

此引用的特定 resourceVersion(如果存在)。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids

.spec.csi

描述

表示由外部 CSI 卷驱动程序管理的存储(测试功能)

类型

对象

必需
  • driver

  • volumeHandle

属性 类型 描述

controllerExpandSecretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

controllerPublishSecretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

driver

字符串

driver 是此卷要使用的驱动程序的名称。必需。

fsType

字符串

要挂载的 fsType。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。

nodeExpandSecretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

nodePublishSecretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

nodeStageSecretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

readOnly

布尔值

要传递给 ControllerPublishVolumeRequest 的 readOnly 值。默认为 false(读写)。

volumeAttributes

对象(字符串)

要发布的卷的 volumeAttributes。

volumeHandle

字符串

volumeHandle 是 CSI 卷插件的 CreateVolume 返回的唯一卷名称,用于在所有后续调用中引用卷。必需。

.spec.csi.controllerExpandSecretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.csi.controllerPublishSecretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.csi.nodeExpandSecretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.csi.nodePublishSecretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.csi.nodeStageSecretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.fc

描述

表示光纤通道卷。光纤通道卷只能以读写方式挂载一次。光纤通道卷支持所有权管理和 SELinux 重新标记。

类型

对象

属性 类型 描述

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。

lun

整数

lun 可选:FC 目标 LUN 号码

readOnly

布尔值

readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。

targetWWNs

数组 (字符串)

targetWWNs 可选:FC 目标全球名称 (WWNs)

wwids

数组 (字符串)

wwids 可选:FC 卷全球标识符 (wwids) 必须设置 wwids 或 targetWWNs 和 lun 的组合,但不能同时设置两者。

.spec.flexVolume

描述

FlexPersistentVolumeSource 表示使用基于 exec 的插件进行预配/附加的通用持久卷资源。

类型

对象

必需
  • driver

属性 类型 描述

driver

字符串

driver 是要为此卷使用的驱动程序的名称。

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。默认文件系统取决于 FlexVolume 脚本。

options

对象(字符串)

options 可选:此字段包含任何额外的命令选项。

readOnly

布尔值

readOnly 可选:默认为 false(读写)。此处的 ReadOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。

secretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

.spec.flexVolume.secretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.flocker

描述

表示由 Flocker 代理挂载的 Flocker 卷。datasetName 和 datasetUUID 中只有一个应该设置。Flocker 卷不支持所有权管理或 SELinux 重新标记。

类型

对象

属性 类型 描述

datasetName

字符串

datasetName 是数据集的名称,存储为数据集上的元数据→名称,Flocker 的数据集名称应视为已弃用。

datasetUUID

字符串

datasetUUID 是数据集的 UUID。这是 Flocker 数据集的唯一标识符。

.spec.gcePersistentDisk

描述

表示 Google Compute Engine 中的持久磁盘资源。

必须在挂载到容器之前存在 GCE PD。磁盘还必须与 kubelet 位于同一 GCE 项目和区域中。GCE PD 只能以读写方式挂载一次或以只读方式挂载多次。GCE PD 支持所有权管理和 SELinux 重新标记。

类型

对象

必需
  • pdName

属性 类型 描述

fsType

字符串

fsType 是您要挂载的卷的文件系统类型。提示:确保主机操作系统支持该文件系统类型。例如:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk

partition

整数

partition 是您要挂载的卷中的分区。如果省略,则默认按卷名称挂载。例如:对于卷 /dev/sda1,您将分区指定为“1”。类似地,/dev/sda 的卷分区为“0”(或者您可以留空该属性)。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk

pdName

字符串

pdName 是 GCE 中 PD 资源的唯一名称。用于在 GCE 中标识磁盘。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

布尔值

此处的 readOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。默认为 false。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk

.spec.glusterfs

描述

表示持续整个 Pod 生命周期 的 Glusterfs 挂载。Glusterfs 卷不支持所有权管理或 SELinux 重新标记。

类型

对象

必需
  • endpoints

  • path

属性 类型 描述

endpoints

字符串

endpoints 是详细说明 Glusterfs 拓扑的端点名称。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

endpointsNamespace

字符串

endpointsNamespace 是包含 Glusterfs 端点的命名空间。如果此字段为空,则 EndpointNamespace 默认与绑定的 PVC 的命名空间相同。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

字符串

path 是 Glusterfs 卷的路径。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

布尔值

readOnly 将强制 Glusterfs 卷以只读权限挂载。默认为 false。更多信息:https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

.spec.hostPath

描述

表示映射到 Pod 的主机路径。主机路径卷不支持所有权管理或 SELinux 重新标记。

类型

对象

必需
  • path

属性 类型 描述

path

字符串

主机上目录的路径。如果路径是符号链接,它将跟随链接到实际路径。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#hostpath

类型

字符串

HostPath 卷的类型,默认为 ""。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#hostpath

可能的枚举值:- "" 为了向后兼容,如果未设置则保持为空 - "BlockDevice" 给定路径必须存在块设备 - "CharDevice" 给定路径必须存在字符设备 - "Directory" 给定路径必须存在目录 - "DirectoryOrCreate" 如果给定路径不存在任何内容,则根据需要在其中创建一个空目录,文件模式为 0755,与 Kubelet 具有相同的组和所有权。 - "File" 给定路径必须存在文件 - "FileOrCreate" 如果给定路径不存在任何内容,则根据需要在其中创建一个空文件,文件模式为 0644,与 Kubelet 具有相同的组和所有权。 - "Socket" 给定路径必须存在 UNIX 套接字

.spec.iscsi

描述

ISCSIPersistentVolumeSource 表示一个 iSCSI 磁盘。iSCSI 卷只能以读写方式挂载一次。iSCSI 卷支持所有权管理和 SELinux 重新标记。

类型

对象

必需
  • 目标Portal

  • iqn

  • lun

属性 类型 描述

chapAuthDiscovery

布尔值

chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证

chapAuthSession

布尔值

chapAuthSession 定义是否支持 iSCSI Session CHAP 身份验证

fsType

字符串

fsType 是您要挂载的卷的文件系统类型。提示:确保主机操作系统支持该文件系统类型。示例:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#iscsi

发起程序名称

字符串

initiatorName 是自定义的 iSCSI 发起程序名称。如果同时指定了 initiatorName 和 iscsiInterface,则将为连接创建新的 iSCSI 接口 <目标门户>:<卷名称>。

iqn

字符串

iqn 是目标 iSCSI 限定名称。

iscsiInterface

字符串

iscsiInterface 是使用 iSCSI 传输的接口名称。默认为“default”(tcp)。

lun

整数

lun 是 iSCSI 目标 LUN 号。

门户

数组 (字符串)

portals 是 iSCSI 目标门户列表。门户是 IP 或 ip_addr:port(如果端口不是默认端口(通常是 TCP 端口 860 和 3260))。

readOnly

布尔值

readOnly 将强制在 VolumeMounts 中设置 ReadOnly。默认为 false。

secretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

目标Portal

字符串

targetPortal 是 iSCSI 目标门户。门户是 IP 或 ip_addr:port(如果端口不是默认端口(通常是 TCP 端口 860 和 3260))。

.spec.iscsi.secretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.local

描述

Local 表示具有节点亲和性的直接连接存储(测试功能)

类型

对象

必需
  • path

属性 类型 描述

fsType

字符串

fsType 是要挂载的文件系统类型。仅当 Path 是块设备时才适用。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则默认为自动选择文件系统。

path

字符串

节点上卷的完整路径。它可以是目录或块设备(磁盘、分区……)。

.spec.nfs

描述

表示持续整个 Pod 生命周期 的 NFS 挂载。NFS 卷不支持所有权管理或 SELinux 重新标记。

类型

对象

必需
  • 服务器

  • path

属性 类型 描述

path

字符串

NFS 服务器导出的路径。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs

readOnly

布尔值

readOnly 将强制 NFS 导出以只读权限挂载。默认为 false。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs

服务器

字符串

server 是 NFS 服务器的主机名或 IP 地址。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs

.spec.nodeAffinity

描述

VolumeNodeAffinity 定义了限制此卷可以从中访问的节点的约束。

类型

对象

属性 类型 描述

必需的

对象

节点选择器表示对一组节点进行的一个或多个标签查询结果的并集;也就是说,它表示节点选择器术语所表示的选择器的 OR。

.spec.nodeAffinity.required

描述

节点选择器表示对一组节点进行的一个或多个标签查询结果的并集;也就是说,它表示节点选择器术语所表示的选择器的 OR。

类型

对象

必需
  • nodeSelectorTerms

属性 类型 描述

nodeSelectorTerms

数组

必需。节点选择器术语列表。这些术语是 ORed 的。

nodeSelectorTerms[]

对象

空或空的节点选择器术语不匹配任何对象。它们的 requirement 是 ANDed 的。TopologySelectorTerm 类型实现了 NodeSelectorTerm 的一个子集。

.spec.nodeAffinity.required.nodeSelectorTerms

描述

必需。节点选择器术语列表。这些术语是 ORed 的。

类型

数组

.spec.nodeAffinity.required.nodeSelectorTerms[]

描述

空或空的节点选择器术语不匹配任何对象。它们的 requirement 是 ANDed 的。TopologySelectorTerm 类型实现了 NodeSelectorTerm 的一个子集。

类型

对象

属性 类型 描述

matchExpressions

数组

根据节点的标签列出节点选择器要求。

matchExpressions[]

对象

节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。

matchFields

数组

根据节点的字段列出节点选择器要求。

matchFields[]

对象

节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。

.spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions

描述

根据节点的标签列出节点选择器要求。

类型

数组

.spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions[]

描述

节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。

类型

对象

必需
  • 运算符

属性 类型 描述

字符串

选择器应用到的标签键。

运算符

字符串

表示键与一组值的关系。有效的运算符是 In、NotIn、Exists、DoesNotExist、Gt 和 Lt。

可能的枚举值:- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

数组 (字符串)

字符串值数组。如果运算符是 In 或 NotIn,则 values 数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则 values 数组必须为空。如果运算符是 Gt 或 Lt,则 values 数组必须只有一个元素,该元素将被解释为整数。此数组在策略性合并修补程序期间被替换。

.spec.nodeAffinity.required.nodeSelectorTerms[].matchFields

描述

根据节点的字段列出节点选择器要求。

类型

数组

.spec.nodeAffinity.required.nodeSelectorTerms[].matchFields[]

描述

节点选择器要求是一个选择器,它包含值、键和一个关联键和值的运算符。

类型

对象

必需
  • 运算符

属性 类型 描述

字符串

选择器应用到的标签键。

运算符

字符串

表示键与一组值的关系。有效的运算符是 In、NotIn、Exists、DoesNotExist、Gt 和 Lt。

可能的枚举值:- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

数组 (字符串)

字符串值数组。如果运算符是 In 或 NotIn,则 values 数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则 values 数组必须为空。如果运算符是 Gt 或 Lt,则 values 数组必须只有一个元素,该元素将被解释为整数。此数组在策略性合并修补程序期间被替换。

.spec.photonPersistentDisk

描述

表示 Photon Controller 持久磁盘资源。

类型

对象

必需
  • pdID

属性 类型 描述

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。

pdID

字符串

pdID 是标识 Photon Controller 持久磁盘的 ID

.spec.portworxVolume

描述

PortworxVolumeSource 表示 Portworx 卷资源。

类型

对象

必需
  • volumeID

属性 类型 描述

fsType

字符串

fSType 表示要挂载的文件系统类型,必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”。如果未指定,则隐式推断为“ext4”。

readOnly

布尔值

readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

volumeID

字符串

volumeID 唯一标识 Portworx 卷

.spec.quobyte

描述

表示持续整个 Pod 生命周期 的 Quobyte 挂载。Quobyte 卷不支持所有权管理或 SELinux 重新标记。

类型

对象

必需
  • 注册表

属性 类型 描述

字符串

将卷访问映射到的组,默认为无组

readOnly

布尔值

readOnly 将强制 Quobyte 卷以只读权限挂载。默认为 false。

注册表

字符串

registry 表示一个或多个 Quobyte 注册表服务,指定为字符串,例如 host:port 对(多个条目用逗号分隔),它充当卷的中央注册表

租户

字符串

在使用动态配置的 Quobyte 卷的后端中拥有给定 Quobyte 卷的租户,该值由插件设置。

user

字符串

用户将卷访问映射到,默认为 service account 用户。

字符串

卷是一个字符串,它通过名称引用一个已创建的 Quobyte 卷。

.spec.rbd

描述

表示持续整个 Pod 生命周期 的 Rados 块设备挂载。RBD 卷支持所有权管理和 SELinux 重新标记。

类型

对象

必需
  • monitors

  • 镜像

属性 类型 描述

fsType

字符串

fsType 是您要挂载的卷的文件系统类型。提示:确保主机操作系统支持该文件系统类型。示例:“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/volumes#rbd

镜像

字符串

image 是 rados 镜像名称。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

密钥环

字符串

keyring 是 RBDUser 的密钥环路径。默认为 /etc/ceph/keyring。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

monitors

数组 (字符串)

monitors 是 Ceph 监控器的集合。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

字符串

pool 是 rados 池名称。默认为 rbd。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

readOnly

布尔值

readOnly 将强制执行 VolumeMounts 中的 ReadOnly 设置。默认为 false。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

user

字符串

user 是 rados 用户名。默认为 admin。更多信息:https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

.spec.rbd.secretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.scaleIO

描述

ScaleIOPersistentVolumeSource 表示持久性 ScaleIO 卷

类型

对象

必需
  • 网关

  • 系统

  • secretRef

属性 类型 描述

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。默认为“xfs”。

网关

字符串

gateway 是 ScaleIO API 网关的主机地址。

保护域

字符串

protectionDomain 是为配置的存储指定的 ScaleIO 保护域的名称。

readOnly

布尔值

readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

secretRef

对象

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

sslEnabled

布尔值

sslEnabled 是启用/禁用与网关的 SSL 通信的标志,默认为 false。

存储模式

字符串

storageMode 指示卷的存储应该是 ThickProvisioned 还是 ThinProvisioned。默认为 ThinProvisioned。

存储池

字符串

storagePool 是与保护域关联的 ScaleIO 存储池。

系统

字符串

system 是在 ScaleIO 中配置的存储系统的名称。

卷名

字符串

volumeName 是已在与该卷源关联的 ScaleIO 系统中创建的卷的名称。

.spec.scaleIO.secretRef

描述

SecretReference 代表一个 Secret 引用。它包含足够的信息来检索任何命名空间中的密钥。

类型

对象

属性 类型 描述

name

字符串

name 在命名空间内是唯一的,用于引用 secret 资源。

namespace

字符串

namespace 定义 secret 名称必须唯一的空间。

.spec.storageos

描述

表示 StorageOS 持久卷资源。

类型

对象

属性 类型 描述

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。

readOnly

布尔值

readOnly 默认为 false(读/写)。此处的 ReadOnly 将强制 VolumeMounts 中的 ReadOnly 设置。

secretRef

对象

ObjectReference 包含足够的信息,可让您检查或修改引用的对象。

卷名

字符串

volumeName 是 StorageOS 卷的可读名称。卷名仅在一个命名空间内唯一。

卷命名空间

字符串

volumeNamespace 指定 StorageOS 中卷的范围。如果未指定命名空间,则将使用 Pod 的命名空间。这允许在 StorageOS 中镜像 Kubernetes 名称范围,以实现更紧密的集成。将 VolumeName 设置为任何名称以覆盖默认行为。如果您没有在 StorageOS 中使用命名空间,则设置为“default”。StorageOS 中不存在的命名空间将被创建。

.spec.storageos.secretRef

描述

ObjectReference 包含足够的信息,可让您检查或修改引用的对象。

类型

对象

属性 类型 描述

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而不是整个对象,则此字符串应包含有效的 JSON/Go 字段访问语句,例如 desiredState.manifest.containers[2]。例如,如果对象引用指向 Pod 中的容器,则其值将类似于:“spec.containers{name}”(其中“name”指的是触发事件的容器的名称)或者如果没有指定容器名称,则为“spec.containers[2]”(此 Pod 中索引为 2 的容器)。选择此语法只是为了有一种明确定义的方式来引用对象的一部分。

kind

字符串

引用的 Kind。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

此引用的特定 resourceVersion(如果存在)。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#uids

.spec.vsphereVolume

描述

表示 vSphere 卷资源。

类型

对象

必需
  • 卷路径

属性 类型 描述

fsType

字符串

fsType 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,“ext4”、“xfs”、“ntfs”。如果未指定,则隐式推断为“ext4”。

存储策略 ID

字符串

storagePolicyID 是与 StoragePolicyName 关联的基于存储策略的管理 (SPBM) 配置文件 ID。

存储策略名称

字符串

storagePolicyName 是基于存储策略的管理 (SPBM) 配置文件名称。

卷路径

字符串

volumePath 是标识 vSphere 卷 vmdk 的路径。

.status

描述

PersistentVolumeStatus 是持久卷的当前状态。

类型

对象

属性 类型 描述

上次阶段转换时间

时间

lastPhaseTransitionTime 是阶段从一个阶段转换到另一个阶段的时间,并且每次卷阶段转换时都会自动重置为当前时间。这是一个测试版字段,需要启用 PersistentVolumeLastPhaseTransitionTime 功能(默认情况下启用)。

消息

字符串

message 是一个易于理解的消息,指示有关卷处于此状态的原因的详细信息。

阶段

字符串

phase 指示卷是可用、绑定到声明还是由声明释放。更多信息:https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#phase

可能的枚举值:- `“Available”` 用于尚未绑定的 PersistentVolumes。可用卷由绑定器持有并与 PersistentVolumeClaims 匹配 - `“Bound”` 用于已绑定的 PersistentVolumes - `“Failed”` 用于在从声明中释放后未能正确回收或删除的 PersistentVolumes - `“Pending”` 用于不可用的 PersistentVolumes - `“Released”` 用于已删除绑定 PersistentVolumeClaim 的 PersistentVolumes。释放的卷必须在再次可用之前进行回收。此阶段由持久卷声明绑定器用于向另一个进程发出信号以回收资源。

原因

字符串

reason 是一个简短的驼峰式字符串,描述任何故障,旨在用于机器解析和在 CLI 中整齐显示。

API 端点

提供以下 API 端点

  • /api/v1/persistentvolumes

    • DELETE:删除 PersistentVolume 集合

    • GET:列出或监视 PersistentVolume 类型对象

    • POST:创建 PersistentVolume

  • /api/v1/watch/persistentvolumes

    • GET:监视 PersistentVolume 列表的单个更改。已弃用:改为使用列表操作的“watch”参数。

  • /api/v1/persistentvolumes/{name}

    • DELETE:删除 PersistentVolume

    • GET:读取指定的 PersistentVolume

    • PATCH:部分更新指定的 PersistentVolume

    • PUT:替换指定的 PersistentVolume

  • /api/v1/watch/persistentvolumes/{name}

    • GET:监视 PersistentVolume 类型对象的更改。已弃用:改为使用列表操作的“watch”参数,并使用“fieldSelector”参数过滤为单个项目。

  • /api/v1/persistentvolumes/{name}/status

    • GET:读取指定的 PersistentVolume 的状态

    • PATCH:部分更新指定的 PersistentVolume 的状态

    • PUT:替换指定的 PersistentVolume 的状态

/api/v1/persistentvolumes

HTTP 方法

DELETE

描述

删除 PersistentVolume 集合

表 1. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

表 2. HTTP 响应
HTTP 代码 响应正文

200 - OK

Status 模式

401 - 未授权

HTTP 方法

GET

描述

列出或监视 PersistentVolume 类型对象

表 3. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolumeList 模式

401 - 未授权

HTTP 方法

POST

描述

创建 PersistentVolume

表 4. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。

表 5. 请求体参数
参数 类型 描述

body

PersistentVolume 模式

表 6. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

201 - 创建成功

PersistentVolume 模式

202 - 已接受

PersistentVolume 模式

401 - 未授权

/api/v1/watch/persistentvolumes

HTTP 方法

GET

描述

监控 PersistentVolume 列表的单个更改。已弃用:请改用列表操作中的“watch”参数。

表 7. HTTP 响应
HTTP 代码 响应正文

200 - OK

WatchEvent 模式

401 - 未授权

/api/v1/persistentvolumes/{name}

表 8. 全局路径参数
参数 类型 描述

name

字符串

PersistentVolume 的名称

HTTP 方法

DELETE

描述

删除 PersistentVolume

表 9. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

表 10. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

202 - 已接受

PersistentVolume 模式

401 - 未授权

HTTP 方法

GET

描述

读取指定的 PersistentVolume

表 11. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定的 PersistentVolume

表 12. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。

表 13. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

201 - 创建成功

PersistentVolume 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定的 PersistentVolume

表 14. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。

表 15. 请求体参数
参数 类型 描述

body

PersistentVolume 模式

表 16. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

201 - 创建成功

PersistentVolume 模式

401 - 未授权

/api/v1/watch/persistentvolumes/{name}

表 17. 全局路径参数
参数 类型 描述

name

字符串

PersistentVolume 的名称

HTTP 方法

GET

描述

监控 PersistentVolume 对象的更改。已弃用:请改用列表操作中的“watch”参数,并使用“fieldSelector”参数过滤为单个项目。

表 18. HTTP 响应
HTTP 代码 响应正文

200 - OK

WatchEvent 模式

401 - 未授权

/api/v1/persistentvolumes/{name}/status

表 19. 全局路径参数
参数 类型 描述

name

字符串

PersistentVolume 的名称

HTTP 方法

GET

描述

读取指定的 PersistentVolume 的状态

表 20. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定的 PersistentVolume 的状态

表 21. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。

表 22. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

201 - 创建成功

PersistentVolume 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定的 PersistentVolume 的状态

表 23. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知字段或重复字段的对象。有效值为:- Ignore:忽略任何未知字段,这些字段将从对象中静默删除,并且只保留解码器遇到的最后一个重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段和遇到的每个重复字段,都会通过标准警告响应标头发送警告。如果没有任何其他错误,请求仍然会成功,并且只会保留任何重复字段中的最后一个。这是 v1.23 及更高版本的默认值。- Strict:如果要从对象中删除任何未知字段,或者存在任何重复字段,则会使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知字段和重复字段。

表 24. 请求体参数
参数 类型 描述

body

PersistentVolume 模式

表 25. HTTP 响应
HTTP 代码 响应正文

200 - OK

PersistentVolume 模式

201 - 创建成功

PersistentVolume 模式

401 - 未授权