V1PersistentVolumeSpec
March 28, 2026 ยท View on GitHub
PersistentVolumeSpec is the specification of a persistent volume.
Properties
| Name | Type | Description | Notes |
|---|---|---|---|
| access_modes | list[str] | accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes | [optional] |
| aws_elastic_block_store | V1AWSElasticBlockStoreVolumeSource | [optional] | |
| azure_disk | V1AzureDiskVolumeSource | [optional] | |
| azure_file | V1AzureFilePersistentVolumeSource | [optional] | |
| capacity | dict[str, str] | capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity | [optional] |
| cephfs | V1CephFSPersistentVolumeSource | [optional] | |
| cinder | V1CinderPersistentVolumeSource | [optional] | |
| claim_ref | V1ObjectReference | [optional] | |
| csi | V1CSIPersistentVolumeSource | [optional] | |
| fc | V1FCVolumeSource | [optional] | |
| flex_volume | V1FlexPersistentVolumeSource | [optional] | |
| flocker | V1FlockerVolumeSource | [optional] | |
| gce_persistent_disk | V1GCEPersistentDiskVolumeSource | [optional] | |
| glusterfs | V1GlusterfsPersistentVolumeSource | [optional] | |
| host_path | V1HostPathVolumeSource | [optional] | |
| iscsi | V1ISCSIPersistentVolumeSource | [optional] | |
| local | V1LocalVolumeSource | [optional] | |
| mount_options | list[str] | mountOptions is the list of mount options, e.g. ["ro", "soft"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options | [optional] |
| nfs | V1NFSVolumeSource | [optional] | |
| node_affinity | V1VolumeNodeAffinity | [optional] | |
| persistent_volume_reclaim_policy | str | persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming | [optional] |
| photon_persistent_disk | V1PhotonPersistentDiskVolumeSource | [optional] | |
| portworx_volume | V1PortworxVolumeSource | [optional] | |
| quobyte | V1QuobyteVolumeSource | [optional] | |
| rbd | V1RBDPersistentVolumeSource | [optional] | |
| scale_io | V1ScaleIOPersistentVolumeSource | [optional] | |
| storage_class_name | str | storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass. | [optional] |
| storageos | V1StorageOSPersistentVolumeSource | [optional] | |
| volume_attributes_class_name | str | Name of VolumeAttributesClass to which this persistent volume belongs. Empty value is not allowed. When this field is not set, it indicates that this volume does not belong to any VolumeAttributesClass. This field is mutable and can be changed by the CSI driver after a volume has been updated successfully to a new class. For an unbound PersistentVolume, the volumeAttributesClassName will be matched with unbound PersistentVolumeClaims during the binding process. | [optional] |
| volume_mode | str | volumeMode defines if a volume is intended to be used with a formatted filesystem or to remain in raw block state. Value of Filesystem is implied when not included in spec. | [optional] |
| vsphere_volume | V1VsphereVirtualDiskVolumeSource | [optional] |