30.16. PersistentVolume [v1]

accessModes

数组（字符串）

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

awsElasticBlockStore

对象

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

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

azureDisk

对象

azureDisk 代表主机上的 Azure Data Disk 挂载，并绑定到 pod。

azureFile

对象

azureFile 代表主机上的 Azure File Service 挂载，并绑定到 pod。

capacity

对象(Quantity)

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

cephfs

对象

代表 Ceph 文件系统挂载，最后一个 pod Cephfs 卷的生命周期不支持所有权管理或 SELinux 重新标记。

cinder

对象

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

claimRef

对象

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

csi

对象

代表由外部 CSI 卷驱动程序管理的存储(Beta 功能)

fc

对象

代表光纤通道卷。Fibre Channel 卷只能挂载为读/写一次。Fibre Channel 卷支持所有权管理和 SELinux 重新标记。

flexVolume

对象

FlexPersistentVolumeSource 代表一个通用持久性卷资源，它使用基于 exec 的插件置备/附加。

flocker

对象

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

gcePersistentDisk

对象

代表 Google Compute Engine 中的 Persistent Disk 资源。

在挂载到容器前，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 代表带有节点关联性(Beta 功能)的直接附加存储

mountOptions

数组（字符串）

挂载选项列表，如 ["ro", "soft"]。not verify - 如果一个无效，挂载将失败。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options

nfs

对象

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

nodeAffinity

对象

VolumeNodeAffinity 定义约束来限制可以从哪些节点访问这个卷。

persistentVolumeReclaimPolicy

字符串

从其声明中释放持久性卷时会发生什么。有效选项为 Retain （手动创建 PersistentVolume 的默认值）、Delete （动态置备的 PersistentVolume 的默认）和 Recycle （已弃用）。这个 PersistentVolume 的卷插件必须支持 Recycle。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming

photonPersistentDisk

对象

代表 Photon Controller 持久磁盘资源。

portworxVolume

对象

PortworxVolumeSource 代表 Portworx 卷资源。

quobyte

对象

代表持续 pod 生命周期的 Quobyte 挂载。quobyte 卷不支持所有权管理或 SELinux 重新标记。

rbd

对象

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

scaleIO

对象

ScaleIOPersistentVolumeSource 代表持久性扩展IO 卷

storageClassName

字符串

此持久性卷所属的 StorageClass 的名称。空值意味着这个卷不属于任何 StorageClass。

storageos

对象

代表 StorageOS 持久性卷资源。

volumeMode

字符串

volumeMode 定义卷是否要与格式化的文件系统一起使用，或者保持在原始块状态。如果没有包含在 spec 中，则 Filesystem 的值会被表示。

vsphereVolume

对象

代表 vSphere 卷资源。

fsType

字符串

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

分区

整数

要挂载的卷中的分区。如果省略，则默认由卷名称挂载。示例：对于卷 /dev/sda1，您可以将分区指定为 "1"。同样，/dev/sda 的卷快照是"0" （或者您可以将属性留空）。

readOnly

布尔值

指定 "true" 来强制并将 VolumeMounts 中的 ReadOnly 属性设置为 "true"。如果省略，则默认为 "false"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

字符串

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

cachingMode

字符串

主机缓存模式：无、只读、读写。

diskName

字符串

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

diskURI

字符串

blob 存储中的数据磁盘的 URI

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

kind

字符串

预期值 Shared: 每个存储帐户 Dedicated 多个 blob 磁盘：每个存储帐户 Managed: azure managed data disk （仅限受管可用性集中）。默认为 shared

readOnly

布尔值

默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

readOnly

布尔值

默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretName

字符串

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

secretNamespace

字符串

包含 Azure Storage Account Name 和 Key default 的 secret 的命名空间与 Pod 相同

shareName

字符串

共享名称

monitor

数组（字符串）

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

path

字符串

可选：用作挂载的 root，而不是完整的 Ceph 树，默认为 /

readOnly

布尔值

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

secretFile

字符串

可选： SecretFile 是用户密钥环的路径，默认为 /etc/ceph/user.secret more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

user

字符串

可选： User 是 rados 用户名，默认为 admin more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

fsType

字符串

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

readOnly

布尔值

可选：默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

volumeID

字符串

用于识别 cinder 中卷的卷 ID。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而非整个对象，则该字符串应包含有效的 JSON/Go 字段访问声明，如 desiredState.manifest.containers[2]。例如，如果对象引用是一个 pod 中的容器，它应该还以下类似： "spec.containers{name}"（其中 "name" 是指触发事件的容器的名称）,如果不使用容器名称，则应类似于 "spec.containers[2]"（使用此 pod 中索引值为 2 的容器）。选择这个语法的原因是，为了有一些指向对象部分的正确定义方法。

kind

字符串

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

name

字符串

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

namespace

字符串

引用的命名空间。更多信息： https://kubernetes.io/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.io/docs/concepts/overview/working-with-objects/names/#uids

controllerExpandSecretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

controllerPublishSecretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

driver

字符串

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

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".

nodePublishSecretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

nodeStageSecretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

readOnly

布尔值

可选：传递给 ControllerPublishVolumeRequest 的值。默认为 false （读/写）。

volumeAttributes

对象（字符串）

要发布的卷的属性。

volumeHandle

字符串

volumeHandle 是 CSI 卷插件的 CreateVolume 返回的唯一卷名称，以引用所有后续调用上的卷。必需。

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

lun

整数

可选： FC 目标 lun 号

readOnly

布尔值

可选：默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

targetWWNs

数组（字符串）

可选： FC 目标全球名称(WWN)

wwids

数组（字符串）

可选： FC 卷全局识别符(wwids) Either wwids 或 targetWWN 和 lun 的组合都必须被设置，但不能同时设置。

driver

字符串

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

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认文件系统依赖于 FlexVolume 脚本。

options

对象（字符串）

可选：额外的命令选项（若有）。

readOnly

布尔值

可选：默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

datasetName

字符串

在 Flocker 的 dataset 上作为 metadata name 存储的数据的名称应被视为已弃用

datasetUUID

字符串

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

fsType

字符串

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

分区

整数

要挂载的卷中的分区。如果省略，则默认由卷名称挂载。示例：对于卷 /dev/sda1，您可以将分区指定为 "1"。同样，/dev/sda 的卷快照是"0" （或者您可以将属性留空）。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

字符串

GCE 中 PD 资源的唯一名称。用于识别 GCE 中的磁盘。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

布尔值

此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

端点

字符串

endpointName 是详细说明 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

布尔值

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

path

字符串

主机上目录的路径。如果路径是符号链接，它将遵循到实际路径的链接。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

字符串

HostPath Volume Defaults 为 "" more information: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

chapAuthDiscovery

布尔值

是否支持 iSCSI 发现 CHAP 身份验证

chapAuthSession

布尔值

是否支持 iSCSI 会话 CHAP 身份验证

fsType

字符串

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

initiatorName

字符串

自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName，则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。

iqn

字符串

目标 iSCSI 限定名称。

iscsiInterface

字符串

使用 iSCSI 传输的 iSCSI 接口名称。默认为 'default'(tcp)。

lun

整数

iSCSI 目标 Lun 号。

门户

数组（字符串）

iSCSI 目标门户列表.如果端口不是默认端口（通常为 TCP 端口 860 和 3260），则门户是 IP 或 ip_addr:port。

readOnly

布尔值

此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。

secretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

targetPortal

字符串

iSCSI 目标门户.如果端口不是默认端口（通常为 TCP 端口 860 和 3260），则门户是 IP 或 ip_addr:port。

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

fsType

字符串

要挂载的文件系统类型。只有在路径是块设备时才适用。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则默认值为 auto-select a fileystem。

path

字符串

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

path

字符串

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

readOnly

布尔值

此处的只读将强制使用只读权限挂载 NFS 导出。默认为false。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

字符串

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

required

对象

节点选择器代表在一组节点上一个或多个标签查询的结果的取消；即，它代表节点选择器术语代表选择器术语的 OR。

nodeSelectorTerms

array

必需。节点选择器术语列表。术语为 ORed。

nodeSelectorTerms[]

对象

空或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。

matchExpressions

array

按节点标签划分的节点选择器要求列表。

matchExpressions[]

对象

节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchFields

array

按节点字段的节点选择器要求列表。

matchFields[]

对象

节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

key

字符串

选择器应用到的标签键。

operator

字符串

代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt。

值

数组（字符串）

字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，该元素将解释为整数。这个数组会在策略性合并补丁中被替换。

key

字符串

选择器应用到的标签键。

operator

字符串

代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt。

值

数组（字符串）

字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果运算符是 Gt 或 Lt，则值数组必须具有单个元素，该元素将解释为整数。这个数组会在策略性合并补丁中被替换。

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

pdID

字符串

标识 Photon Controller 持久磁盘的 ID

fsType

字符串

fstype 代表要挂载 Must 的文件系统类型，是主机操作系统支持的文件系统类型。EX. "ext4", "xfs"。如果未指定，则隐式推断为"ext4"。

readOnly

布尔值

默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

volumeID

字符串

VolumeId 唯一标识 Portworx 卷

group

字符串

将卷访问映射到 Default 的组

readOnly

布尔值

此处的只读将强制使用只读权限挂载 Quobyte 卷。默认为false。

registry

字符串

registry 代表单个或多个 Quobyte Registry 服务，指定为 host:port 对（多个条目用逗号分开），它充当卷的中央 registry

tenant

字符串

在带有动态置备的 Quobyte 卷的后端中拥有给定 Quobyte 卷的租户，值由插件设置

user

字符串

将卷访问权限映射到 Defaults 到 serivceaccount 用户

卷

字符串

卷是一个字符串，它按名称引用已创建 Quobyte 卷。

fsType

字符串

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

镜像

字符串

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

keyring

字符串

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

monitor

数组（字符串）

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 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息： https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

user

字符串

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

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认为 "xfs"

gateway

字符串

ScaleIO API 网关的主机地址。

protectionDomain

字符串

配置存储的 ScaleIO 保护域的名称。

readOnly

布尔值

默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

对象

secretReference 代表 Secret 参考。它有足够的信息来检索任何命名空间中的 secret

sslEnabled

布尔值

启用/禁用与网关的 SSL 通信的标志，默认为 false

storageMode

字符串

指明卷的存储是否应是 ThickProvisioned 或 ThinProvisioned。默认为 ThinProvisioned。

storagePool

字符串

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

system

字符串

存储系统的名称，如 ScaleIO 中配置的。

volumeName

字符串

已在与这个卷源关联的 ScaleIO 系统中创建的卷名称。

name

字符串

名称在命名空间中唯一用于引用 secret 资源。

namespace

字符串

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

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

readOnly

布尔值

默认为 false （读/写）。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。

secretRef

对象

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

volumeName

字符串

volumeName 是 StorageOS 卷的人类可读名称。卷名称只在命名空间中唯一。

volumeNamespace

字符串

VolumeNamespace 指定 StorageOS 中的卷范围。如果没有指定命名空间，则使用 Pod 的命名空间。这允许 Kubernetes 名称范围在 StorageOS 中进行镜像，以便更好地集成。将 VolumeName 设置为任何名称来覆盖默认行为。如果没有在 StorageOS 中使用命名空间，则设置为 "default"。将创建没有在 StorageOS 中预先存在的命名空间。

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而非整个对象，则该字符串应包含有效的 JSON/Go 字段访问声明，如 desiredState.manifest.containers[2]。例如，如果对象引用是一个 pod 中的容器，它应该还以下类似： "spec.containers{name}"（其中 "name" 是指触发事件的容器的名称）,如果不使用容器名称，则应类似于 "spec.containers[2]"（使用此 pod 中索引值为 2 的容器）。选择这个语法的原因是，为了有一些指向对象部分的正确定义方法。

kind

字符串

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

name

字符串

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

namespace

字符串

引用的命名空间。更多信息： https://kubernetes.io/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.io/docs/concepts/overview/working-with-objects/names/#uids

fsType

字符串

要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

storagePolicyID

字符串

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

storagePolicyName

字符串

基于存储策略的管理(SPBM)配置集名称。

volumePath

字符串

标识 vSphere 卷 vmdk 的路径

message

字符串

人类可读的消息，指示卷处于此状态的原因。

phase

字符串

phase 表示卷是否可用、绑定到声明或由声明释放。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase

reason

字符串

reason 是一个简短的 CamelCase 字符串，用于描述任何故障，用于在 CLI 中解析和 tidy 显示。

pretty

字符串

如果 'true'，则输出被用户友善。

继续

字符串

从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。

当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

gracePeriodSeconds

整数

应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。

orphanDependents

布尔值

弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

正文（body）

DeleteOptions 模式

200 - OK

Status 模式

401 - Unauthorized

空

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。

继续

字符串

从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。

当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

200 - OK

PersistentVolumeList 模式

401 - 未授权

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

正文（body）

PersistentVolume 模式

200 - OK

PersistentVolume 模式

201 - Created

PersistentVolume 模式

202 - Accepted

PersistentVolume 模式

401 - 未授权

空

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。

继续

字符串

从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。

当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true'，则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

200 - OK

WatchEvent 模式

401 - Unauthorized

空

name

字符串

PersistentVolume 的名称

pretty

字符串

如果 'true'，则输出被用户友善。

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。

正文（body）

DeleteOptions 模式

200 - OK

PersistentVolume 模式

202 - Accepted

PersistentVolume 模式

401 - 未授权

空

200 - OK

PersistentVolume 模式

401 - 未授权

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。

正文（body）

Patch 模式

200 - OK

PersistentVolume 模式

201 - Created

PersistentVolume 模式

401 - 未授权

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

正文（body）

PersistentVolume 模式

200 - OK

PersistentVolume 模式

201 - Created

PersistentVolume 模式

401 - 未授权

空

name

字符串

PersistentVolume 的名称

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。

继续

字符串

从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。

当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true'，则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

200 - OK

WatchEvent 模式

401 - Unauthorized

空

name

字符串

PersistentVolume 的名称

pretty

字符串

如果 'true'，则输出被用户友善。

200 - OK

PersistentVolume 模式

401 - 未授权

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。

正文（body）

Patch 模式

200 - OK

PersistentVolume 模式

201 - Created

PersistentVolume 模式

401 - 未授权

空

dryRun

字符串

出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

正文（body）

PersistentVolume 模式

200 - OK

PersistentVolume 模式

201 - Created

PersistentVolume 模式

401 - 未授权

空