kubernetes reference kind PersistentVolume weight 7 apiVersion v1 contenttype apireference apimetadata autogenerated true PersistentVolume PV is a storage resource provisioned by an administrator title PersistentVolume import k8s io api core v1

Answer:
---
api_metadata:
  apiVersion: "v1"
  import: "k8s.io/api/core/v1"
  kind: "PersistentVolume"
content_type: "api_reference"
description: "PersistentVolume (PV) is a storage resource provisioned by an administrator."
title: "PersistentVolume"
weight: 7
auto_generated: true
---

`apiVersion: v1`

`import "k8s.io/api/core/v1"`

## PersistentVolume {#PersistentVolume}

PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes

- **apiVersion**: v1

- **kind**: PersistentVolume

- **metadata** (ObjectMeta)

  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

- **spec** (PersistentVolumeSpec)

  spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes

- **status** (PersistentVolumeStatus)

  status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes

## PersistentVolumeSpec {#PersistentVolumeSpec}

PersistentVolumeSpec is the specification of a persistent volume.

- **accessModes** ([]string)

  *Atomic: will be replaced during a merge*

  accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes

- **capacity** (map[string]Quantity)

  capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity

- **claimRef** (ObjectReference)

  claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding

- **mountOptions** ([]string)

  *Atomic: will be replaced during a merge*

  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

- **nodeAffinity** (VolumeNodeAffinity)

  nodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume.

  *VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.*

  - **nodeAffinity.required** (NodeSelector)

    required specifies hard node constraints that must be met.

    *A node selector represents the union of the results of one or more label queries over a set of nodes; that is, it represents the OR of the selectors represented by the node selector terms.*

    - **nodeAffinity.required.nodeSelectorTerms** ([]NodeSelectorTerm), required

      *Atomic: will be replaced during a merge*

      Required. A list of node selector terms. The terms are ORed.

      *A null or empty node selector term matches no objects. The requirements of them are ANDed. The TopologySelectorTerm type implements a subset of the NodeSelectorTerm.*

      - **nodeAffinity.required.nodeSelectorTerms.matchExpressions** ([]NodeSelectorRequirement)

        *Atomic: will be replaced during a merge*

        A list of node selector requirements by node's labels.

      - **nodeAffinity.required.nodeSelectorTerms.matchFields** ([]NodeSelectorRequirement)

        *Atomic: will be replaced during a merge*

        A list of node selector requirements by node's fields.

- **persistentVolumeReclaimPolicy** (string)

  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

- **storageClassName** (string)

  storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.

- **volumeAttributesClassName** (string)

  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. This is a beta field and requires enabling VolumeAttributesClass feature (off by default).

- **volumeMode** (string)

  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.

### Local

- **hostPath** (HostPathVolumeSource)

  hostPath represents a directory on the host. Provisioned by a developer or tester. This is useful for single-node development and testing only! On-host storage is not supported in any way and WILL NOT WORK in a multi-node cluster. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

  *Represents a host path mapped into a pod. Host path volumes do not support ownership management or SELinux relabeling.*

  - **hostPath.path** (string), required

    path of the directory on the host. If the path is a symlink, it will follow the link to the real path. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

  - **hostPath.type** (string)

    type for HostPath Volume Defaults to "" More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

- **local** (LocalVolumeSource)

  local represents directly-attached storage with node affinity

  *Local represents directly-attached storage with node affinity (Beta feature)*

  - **local.path** (string), required

    path of the full path to the volume on the node. It can be either a directory or block device (disk, partition, ...).

  - **local.fsType** (string)

    fsType is the filesystem type to mount. It applies only when the Path is a block device. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default value is to auto-select a filesystem if unspecified.

### Persistent volumes

- **awsElasticBlockStore** (AWSElasticBlockStoreVolumeSource)

  awsElasticBlockStore represents an AWS Disk resource that is attached to a kubelet's host machine and then exposed to the pod. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

  *Represents a Persistent Disk resource in AWS.

  An AWS EBS disk must exist before mounting to a container. The disk must also be in the same AWS zone as the kubelet. An AWS EBS disk can only be mounted as read/write once. AWS EBS volumes support ownership management and SELinux relabeling.*

  - **awsElasticBlockStore.volumeID** (string), required

    volumeID is unique ID of the persistent disk resource in AWS (Amazon EBS volume). More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

  - **awsElasticBlockStore.fsType** (string)

    fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

  - **awsElasticBlockStore.partition** (int32)

    partition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty).

  - **awsElasticBlockStore.readOnly** (boolean)

    readOnly value true will force the readOnly setting in VolumeMounts. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

- **azureDisk** (AzureDiskVolumeSource)

  azureDisk represents an Azure Data Disk mount on the host and bind mount to the pod.

  *AzureDisk represents an Azure Data Disk mount on the host and bind mount to the pod.*

  - **azureDisk.diskName** (string), required

    diskName is the Name of the data disk in the blob storage

  - **azureDisk.diskURI** (string), required

    diskURI is the URI of data disk in the blob storage

  - **azureDisk.cachingMode** (string)

    cachingMode is the Host Caching mode: None, Read Only, Read Write.

  - **azureDisk.fsType** (string)

    fsType is Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.

  - **azureDisk.kind** (string)

    kind expected values are Shared: multiple blob disks per storage account  Dedicated: single blob disk per storage account  Managed: azure managed data disk (only in managed availability set). defaults to shared

  - **azureDisk.readOnly** (boolean)

    readOnly Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

- **azureFile** (AzureFilePersistentVolumeSource)

  azureFile represents an Azure File Service mount on the host and bind mount to the pod.

  *AzureFile represents an Azure File Service mount on the host and bind mount to the pod.*

  - **azureFile.secretName** (string), required

    secretName is the name of secret that contains Azure Storage Account Name and Key

  - **azureFile.shareName** (string), required

    shareName is the azure Share Name

  - **azureFile.readOnly** (boolean)

    readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

  - **azureFile.secretNamespace** (string)

    secretNamespace is the namespace of the secret that contains Azure Storage Account Name and Key default is the same as the Pod

- **cephfs** (CephFSPersistentVolumeSource)

  cephFS represents a Ceph FS mount on the host that shares a pod's lifetime

  *Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.*

  - **cephfs.monitors** ([]string), required

    *Atomic: will be replaced during a merge*

    monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

  - **cephfs.path** (string)

    path is Optional: Used as the mounted root, rather than the full Ceph tree, default is /

  - **cephfs.readOnly** (boolean)

    readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

  - **cephfs.secretFile** (string)

    secretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

  - **cephfs.secretRef** (SecretReference)

    secretRef is Optional: SecretRef is reference to the authentication secret for User, default is empty. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **cephfs.secretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **cephfs.secretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **cephfs.user** (string)

    user is Optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

- **cinder** (CinderPersistentVolumeSource)

  cinder represents a cinder volume attached and mounted on kubelets host machine. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

  *Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.*

  - **cinder.volumeID** (string), required

    volumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

  - **cinder.fsType** (string)

    fsType Filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

  - **cinder.readOnly** (boolean)

    readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

  - **cinder.secretRef** (SecretReference)

    secretRef is Optional: points to a secret object containing parameters used to connect to OpenStack.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **cinder.secretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **cinder.secretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

- **csi** (CSIPersistentVolumeSource)

  csi represents storage that is handled by an external CSI driver (Beta feature).

  *Represents storage that is managed by an external CSI volume driver (Beta feature)*

  - **csi.driver** (string), required

    driver is the name of the driver to use for this volume. Required.

  - **csi.volumeHandle** (string), required

    volumeHandle is the unique volume name returned by the CSI volume plugin’s CreateVolume to refer to the volume on all subsequent calls. Required.

  - **csi.controllerExpandSecretRef** (SecretReference)

    controllerExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI ControllerExpandVolume call. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secrets are passed.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **csi.controllerExpandSecretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **csi.controllerExpandSecretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **csi.controllerPublishSecretRef** (SecretReference)

    controllerPublishSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI ControllerPublishVolume and ControllerUnpublishVolume calls. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secrets are passed.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **csi.controllerPublishSecretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **csi.controllerPublishSecretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **csi.fsType** (string)

    fsType to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs".

  - **csi.nodeExpandSecretRef** (SecretReference)

    nodeExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodeExpandVolume call. This field is optional, may be omitted if no secret is required. If the secret object contains more than one secret, all secrets are passed.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **csi.nodeExpandSecretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **csi.nodeExpandSecretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **csi.nodePublishSecretRef** (SecretReference)

    nodePublishSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodePublishVolume and NodeUnpublishVolume calls. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secrets are passed.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **csi.nodePublishSecretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **csi.nodePublishSecretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **csi.nodeStageSecretRef** (SecretReference)

    nodeStageSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodeStageVolume and NodeStageVolume and NodeUnstageVolume calls. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secrets are passed.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **csi.nodeStageSecretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **csi.nodeStageSecretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **csi.readOnly** (boolean)

    readOnly value to pass to ControllerPublishVolumeRequest. Defaults to false (read/write).

  - **csi.volumeAttributes** (map[string]string)

    volumeAttributes of the volume to publish.

- **fc** (FCVolumeSource)

  fc represents a Fibre Channel resource that is attached to a kubelet's host machine and then exposed to the pod.

  *Represents a Fibre Channel volume. Fibre Channel volumes can only be mounted as read/write once. Fibre Channel volumes support ownership management and SELinux relabeling.*

  - **fc.fsType** (string)

    fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.

  - **fc.lun** (int32)

    lun is Optional: FC target lun number

  - **fc.readOnly** (boolean)

    readOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

  - **fc.targetWWNs** ([]string)

    *Atomic: will be replaced during a merge*

    targetWWNs is Optional: FC target worldwide names (WWNs)

  - **fc.wwids** ([]string)

    *Atomic: will be replaced during a merge*

    wwids Optional: FC volume world wide identifiers (wwids) Either wwids or combination of targetWWNs and lun must be set, but not both simultaneously.

- **flexVolume** (FlexPersistentVolumeSource)

  flexVolume represents a generic volume resource that is provisioned/attached using an exec based plugin.

  *FlexPersistentVolumeSource represents a generic persistent volume resource that is provisioned/attached using an exec based plugin.*

  - **flexVolume.driver** (string), required

    driver is the name of the driver to use for this volume.

  - **flexVolume.fsType** (string)

    fsType is the Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.

  - **flexVolume.options** (map[string]string)

    options is Optional: this field holds extra command options if any.

  - **flexVolume.readOnly** (boolean)

    readOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

  - **flexVolume.secretRef** (SecretReference)

    secretRef is Optional: SecretRef is reference to the secret object containing sensitive information to pass to the plugin scripts. This may be empty if no secret object is specified. If the secret object contains more than one secret, all secrets are passed to the plugin scripts.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **flexVolume.secretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **flexVolume.secretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

- **flocker** (FlockerVolumeSource)

  flocker represents a Flocker volume attached to a kubelet's host machine and exposed to the pod for its usage. This depends on the Flocker control service being running

  *Represents a Flocker volume mounted by the Flocker agent. One and only one of datasetName and datasetUUID should be set. Flocker volumes do not support ownership management or SELinux relabeling.*

  - **flocker.datasetName** (string)

    datasetName is Name of the dataset stored as metadata -> name on the dataset for Flocker should be considered as deprecated

  - **flocker.datasetUUID** (string)

    datasetUUID is the UUID of the dataset. This is unique identifier of a Flocker dataset

- **gcePersistentDisk** (GCEPersistentDiskVolumeSource)

  gcePersistentDisk represents a GCE Disk resource that is attached to a kubelet's host machine and then exposed to the pod. Provisioned by an admin. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

  *Represents a Persistent Disk resource in Google Compute Engine.

  A GCE PD must exist before mounting to a container. The disk must also be in the same GCE project and zone as the kubelet. A GCE PD can only be mounted as read/write once or read-only many times. GCE PDs support ownership management and SELinux relabeling.*

  - **gcePersistentDisk.pdName** (string), required

    pdName is unique name of the PD resource in GCE. Used to identify the disk in GCE. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

  - **gcePersistentDisk.fsType** (string)

    fsType is filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

  - **gcePersistentDisk.partition** (int32)

    partition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the volume partition for /dev/sda is "0" (or you can leave the property empty). More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

  - **gcePersistentDisk.readOnly** (boolean)

    readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

- **glusterfs** (GlusterfsPersistentVolumeSource)

  glusterfs represents a Glusterfs volume that is attached to a host and exposed to the pod. Provisioned by an admin. More info: https://examples.k8s.io/volumes/glusterfs/README.md

  *Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.*

  - **glusterfs.endpoints** (string), required

    endpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

  - **glusterfs.path** (string), required

    path is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

  - **glusterfs.endpointsNamespace** (string)

    endpointsNamespace is the namespace that contains Glusterfs endpoint. If this field is empty, the EndpointNamespace defaults to the same namespace as the bound PVC. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

  - **glusterfs.readOnly** (boolean)

    readOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

- **iscsi** (ISCSIPersistentVolumeSource)

  iscsi represents an ISCSI Disk resource that is attached to a kubelet's host machine and then exposed to the pod. Provisioned by an admin.

  *ISCSIPersistentVolumeSource represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.*

  - **iscsi.iqn** (string), required

    iqn is Target iSCSI Qualified Name.

  - **iscsi.lun** (int32), required

    lun is iSCSI Target Lun number.

  - **iscsi.targetPortal** (string), required

    targetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).

  - **iscsi.chapAuthDiscovery** (boolean)

    chapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication

  - **iscsi.chapAuthSession** (boolean)

    chapAuthSession defines whether support iSCSI Session CHAP authentication

  - **iscsi.fsType** (string)

    fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#iscsi

  - **iscsi.initiatorName** (string)

    initiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface \<target portal>:\<volume name> will be created for the connection.

  - **iscsi.iscsiInterface** (string)

    iscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).

  - **iscsi.portals** ([]string)

    *Atomic: will be replaced during a merge*

    portals is the iSCSI Target Portal List. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).

  - **iscsi.readOnly** (boolean)

    readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.

  - **iscsi.secretRef** (SecretReference)

    secretRef is the CHAP Secret for iSCSI target and initiator authentication

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **iscsi.secretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **iscsi.secretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

- **nfs** (NFSVolumeSource)

  nfs represents an NFS mount on the host. Provisioned by an admin. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs

  *Represents an NFS mount that lasts the lifetime of a pod. NFS volumes do not support ownership management or SELinux relabeling.*

  - **nfs.path** (string), required

    path that is exported by the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs

  - **nfs.server** (string), required

    server is the hostname or IP address of the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs

  - **nfs.readOnly** (boolean)

    readOnly here will force the NFS export to be mounted with read-only permissions. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs

- **photonPersistentDisk** (PhotonPersistentDiskVolumeSource)

  photonPersistentDisk represents a PhotonController persistent disk attached and mounted on kubelets host machine

  *Represents a Photon Controller persistent disk resource.*

  - **photonPersistentDisk.pdID** (string), required

    pdID is the ID that identifies Photon Controller persistent disk

  - **photonPersistentDisk.fsType** (string)

    fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.

- **portworxVolume** (PortworxVolumeSource)

  portworxVolume represents a portworx volume attached and mounted on kubelets host machine

  *PortworxVolumeSource represents a Portworx volume resource.*

  - **portworxVolume.volumeID** (string), required

    volumeID uniquely identifies a Portworx volume

  - **portworxVolume.fsType** (string)

    fSType represents the filesystem type to mount Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs". Implicitly inferred to be "ext4" if unspecified.

  - **portworxVolume.readOnly** (boolean)

    readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

- **quobyte** (QuobyteVolumeSource)

  quobyte represents a Quobyte mount on the host that shares a pod's lifetime

  *Represents a Quobyte mount that lasts the lifetime of a pod. Quobyte volumes do not support ownership management or SELinux relabeling.*

  - **quobyte.registry** (string), required

    registry represents a single or multiple Quobyte Registry services specified as a string as host:port pair (multiple entries are separated with commas) which acts as the central registry for volumes

  - **quobyte.volume** (string), required

    volume is a string that references an already created Quobyte volume by name.

  - **quobyte.group** (string)

    group to map volume access to Default is no group

  - **quobyte.readOnly** (boolean)

    readOnly here will force the Quobyte volume to be mounted with read-only permissions. Defaults to false.

  - **quobyte.tenant** (string)

    tenant owning the given Quobyte volume in the Backend Used with dynamically provisioned Quobyte volumes, value is set by the plugin

  - **quobyte.user** (string)

    user to map volume access to Defaults to serivceaccount user

- **rbd** (RBDPersistentVolumeSource)

  rbd represents a Rados Block Device mount on the host that shares a pod's lifetime. More info: https://examples.k8s.io/volumes/rbd/README.md

  *Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.*

  - **rbd.image** (string), required

    image is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

  - **rbd.monitors** ([]string), required

    *Atomic: will be replaced during a merge*

    monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

  - **rbd.fsType** (string)

    fsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#rbd

  - **rbd.keyring** (string)

    keyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

  - **rbd.pool** (string)

    pool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

  - **rbd.readOnly** (boolean)

    readOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

  - **rbd.secretRef** (SecretReference)

    secretRef is name of the authentication secret for RBDUser. If provided overrides keyring. Default is nil. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **rbd.secretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **rbd.secretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **rbd.user** (string)

    user is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

- **scaleIO** (ScaleIOPersistentVolumeSource)

  scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes.

  *ScaleIOPersistentVolumeSource represents a persistent ScaleIO volume*

  - **scaleIO.gateway** (string), required

    gateway is the host address of the ScaleIO API Gateway.

  - **scaleIO.secretRef** (SecretReference), required

    secretRef references to the secret for ScaleIO user and other sensitive information. If this is not provided, Login operation will fail.

    *SecretReference represents a Secret Reference. It has enough information to retrieve secret in any namespace*

    - **scaleIO.secretRef.name** (string)

      name is unique within a namespace to reference a secret resource.

    - **scaleIO.secretRef.namespace** (string)

      namespace defines the space within which the secret name must be unique.

  - **scaleIO.system** (string), required

    system is the name of the storage system as configured in ScaleIO.

  - **scaleIO.fsType** (string)

    fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Default is "xfs"

  - **scaleIO.protectionDomain** (string)

    protectionDomain is the name of the ScaleIO Protection Domain for the configured storage.

  - **scaleIO.readOnly** (boolean)

    readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

  - **scaleIO.sslEnabled** (boolean)

    sslEnabled is the flag to enable/disable SSL communication with Gateway, default false

  - **scaleIO.storageMode** (string)

    storageMode indicates whether the storage for a volume should be ThickProvisioned or ThinProvisioned. Default is ThinProvisioned.

  - **scaleIO.storagePool** (string)

    storagePool is the ScaleIO Storage Pool associated with the protection domain.

  - **scaleIO.volumeName** (string)

    volumeName is the name of a volume already created in the ScaleIO system that is associated with this volume source.

- **storageos** (StorageOSPersistentVolumeSource)

  storageOS represents a StorageOS volume that is attached to the kubelet's host machine and mounted into the pod More info: https://examples.k8s.io/volumes/storageos/README.md

  *Represents a StorageOS persistent volume resource.*

  - **storageos.fsType** (string)

    fsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.

  - **storageos.readOnly** (boolean)

    readOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

  - **storageos.secretRef** (ObjectReference)

    secretRef specifies the secret to use for obtaining the StorageOS API credentials.  If not specified, default values will be attempted.

  - **storageos.volumeName** (string)

    volumeName is the human-readable name of the StorageOS volume.  Volume names are only unique within a namespace.

  - **storageos.volumeNamespace** (string)

    volumeNamespace specifies the scope of the volume within StorageOS.  If no namespace is specified then the Pod's namespace will be used.  This allows the Kubernetes name scoping to be mirrored within StorageOS for tighter integration. Set VolumeName to any name to override the default behaviour. Set to "default" if you are not using namespaces within StorageOS. Namespaces that do not pre-exist within StorageOS will be created.

- **vsphereVolume** (VsphereVirtualDiskVolumeSource)

  vsphereVolume represents a vSphere volume attached and mounted on kubelets host machine

  *Represents a vSphere volume resource.*

  - **vsphereVolume.volumePath** (string), required

    volumePath is the path that identifies vSphere volume vmdk

  - **vsphereVolume.fsType** (string)

    fsType is filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.

  - **vsphereVolume.storagePolicyID** (string)

    storagePolicyID is the storage Policy Based Management (SPBM) profile ID associated with the StoragePolicyName.

  - **vsphereVolume.storagePolicyName** (string)

    storagePolicyName is the storage Policy Based Management (SPBM) profile name.

## PersistentVolumeStatus {#PersistentVolumeStatus}

PersistentVolumeStatus is the current status of a persistent volume.

- **lastPhaseTransitionTime** (Time)

  lastPhaseTransitionTime is the time the phase transitioned from one to another and automatically resets to current time everytime a volume phase transitions.

  *Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.*

- **message** (string)

  message is a human-readable message indicating details about why the volume is in this state.

- **phase** (string)

  phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase

- **reason** (string)

  reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.

## PersistentVolumeList {#PersistentVolumeList}

PersistentVolumeList is a list of PersistentVolume items.

- **apiVersion**: v1

- **kind**: PersistentVolumeList

- **metadata** (ListMeta)

  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

- **items** ([]PersistentVolume), required

  items is a list of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes

## Operations {#Operations}

### `get` read the specified PersistentVolume

#### HTTP Request

GET /api/v1/persistentvolumes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

401: Unauthorized

### `get` read status of the specified PersistentVolume

#### HTTP Request

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

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

401: Unauthorized

### `list` list or watch objects of kind PersistentVolume

#### HTTP Request

GET /api/v1/persistentvolumes

#### Parameters

- **allowWatchBookmarks** (*in query*): boolean

  allowWatchBookmarks

- **continue** (*in query*): string

  continue

- **fieldSelector** (*in query*): string

  fieldSelector

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

- **watch** (*in query*): boolean

  watch

#### Response

200 (PersistentVolumeList): OK

401: Unauthorized

### `create` create a PersistentVolume

#### HTTP Request

POST /api/v1/persistentvolumes

#### Parameters

- **body**: PersistentVolume, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

201 (PersistentVolume): Created

202 (PersistentVolume): Accepted

401: Unauthorized

### `update` replace the specified PersistentVolume

#### HTTP Request

PUT /api/v1/persistentvolumes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **body**: PersistentVolume, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

201 (PersistentVolume): Created

401: Unauthorized

### `update` replace status of the specified PersistentVolume

#### HTTP Request

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

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **body**: PersistentVolume, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

201 (PersistentVolume): Created

401: Unauthorized

### `patch` partially update the specified PersistentVolume

#### HTTP Request

PATCH /api/v1/persistentvolumes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

201 (PersistentVolume): Created

401: Unauthorized

### `patch` partially update status of the specified PersistentVolume

#### HTTP Request

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

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **body**: Patch, required

- **dryRun** (*in query*): string

  dryRun

- **fieldManager** (*in query*): string

  fieldManager

- **fieldValidation** (*in query*): string

  fieldValidation

- **force** (*in query*): boolean

  force

- **pretty** (*in query*): string

  pretty

#### Response

200 (PersistentVolume): OK

201 (PersistentVolume): Created

401: Unauthorized

### `delete` delete a PersistentVolume

#### HTTP Request

DELETE /api/v1/persistentvolumes/{name}

#### Parameters

- **name** (*in path*): string, required

  name of the PersistentVolume

- **body**: DeleteOptions

- **dryRun** (*in query*): string

  dryRun

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

#### Response

200 (PersistentVolume): OK

202 (PersistentVolume): Accepted

401: Unauthorized

### `deletecollection` delete collection of PersistentVolume

#### HTTP Request

DELETE /api/v1/persistentvolumes

#### Parameters

- **body**: DeleteOptions

- **continue** (*in query*): string

  continue

- **dryRun** (*in query*): string

  dryRun

- **fieldSelector** (*in query*): string

  fieldSelector

- **gracePeriodSeconds** (*in query*): integer

  gracePeriodSeconds

- **labelSelector** (*in query*): string

  labelSelector

- **limit** (*in query*): integer

  limit

- **pretty** (*in query*): string

  pretty

- **propagationPolicy** (*in query*): string

  propagationPolicy

- **resourceVersion** (*in query*): string

  resourceVersion

- **resourceVersionMatch** (*in query*): string

  resourceVersionMatch

- **sendInitialEvents** (*in query*): boolean

  sendInitialEvents

- **timeoutSeconds** (*in query*): integer

  timeoutSeconds

#### Response

200 (Status): OK

401: Unauthorized

api metadata    apiVersion   v1    import   k8s io api core v1    kind   PersistentVolume  content type   api reference  description   PersistentVolume  PV  is a storage resource provisioned by an administrator   title   PersistentVolume  weight  7 auto generated  true           The file is auto generated from the Go source code of the component using a generic  generator  https   github com kubernetes sigs reference docs    To learn how to generate the reference documentation  please read  Contributing to the reference documentation   docs contribute generate ref docs    To update the reference content  please follow the   Contributing upstream   docs contribute generate ref docs contribute upstream   guide  You can file document formatting bugs against the  reference docs  https   github com kubernetes sigs reference docs   project        apiVersion  v1    import  k8s io api core v1        PersistentVolume   PersistentVolume   PersistentVolume  PV  is a storage resource provisioned by an administrator  It is analogous to a node  More info  https   kubernetes io docs concepts storage persistent volumes   hr       apiVersion    v1       kind    PersistentVolume       metadata     a href    ObjectMeta  a      Standard object s metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md metadata      spec     a href    PersistentVolumeSpec  a      spec defines a specification of a persistent volume owned by the cluster  Provisioned by an administrator  More info  https   kubernetes io docs concepts storage persistent volumes persistent volumes      status     a href    PersistentVolumeStatus  a      status represents the current information status for the persistent volume  Populated by the system  Read only  More info  https   kubernetes io docs concepts storage persistent volumes persistent volumes         PersistentVolumeSpec   PersistentVolumeSpec   PersistentVolumeSpec is the specification of a persistent volume    hr       accessModes      string      Atomic  will be replaced during a merge       accessModes contains all ways the volume can be mounted  More info  https   kubernetes io docs concepts storage persistent volumes access modes      capacity    map string  a href    Quantity  a      capacity is the description of the persistent volume s resources and capacity  More info  https   kubernetes io docs concepts storage persistent volumes capacity      claimRef     a href    ObjectReference  a      claimRef is part of a bi directional binding between PersistentVolume and PersistentVolumeClaim  Expected to be non nil when bound  claim VolumeName is the authoritative bind between PV and PVC  More info  https   kubernetes io docs concepts storage persistent volumes binding      mountOptions      string      Atomic  will be replaced during a merge       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      nodeAffinity    VolumeNodeAffinity     nodeAffinity defines constraints that limit what nodes this volume can be accessed from  This field influences the scheduling of pods that use this volume      a name  VolumeNodeAffinity    a     VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from          nodeAffinity required    NodeSelector       required specifies hard node constraints that must be met        a name  NodeSelector    a       A node selector represents the union of the results of one or more label queries over a set of nodes  that is  it represents the OR of the selectors represented by the node selector terms            nodeAffinity required nodeSelectorTerms      NodeSelectorTerm   required         Atomic  will be replaced during a merge               Required  A list of node selector terms  The terms are ORed          a name  NodeSelectorTerm    a         A null or empty node selector term matches no objects  The requirements of them are ANDed  The TopologySelectorTerm type implements a subset of the NodeSelectorTerm              nodeAffinity required nodeSelectorTerms matchExpressions       a href    NodeSelectorRequirement  a             Atomic  will be replaced during a merge                   A list of node selector requirements by node s labels             nodeAffinity required nodeSelectorTerms matchFields       a href    NodeSelectorRequirement  a             Atomic  will be replaced during a merge                   A list of node selector requirements by node s fields       persistentVolumeReclaimPolicy    string     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      storageClassName    string     storageClassName is the name of StorageClass to which this persistent volume belongs  Empty value means that this volume does not belong to any StorageClass       volumeAttributesClassName    string     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  This is a beta field and requires enabling VolumeAttributesClass feature  off by default        volumeMode    string     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         Local       hostPath    HostPathVolumeSource     hostPath represents a directory on the host  Provisioned by a developer or tester  This is useful for single node development and testing only  On host storage is not supported in any way and WILL NOT WORK in a multi node cluster  More info  https   kubernetes io docs concepts storage volumes hostpath     a name  HostPathVolumeSource    a     Represents a host path mapped into a pod  Host path volumes do not support ownership management or SELinux relabeling          hostPath path    string   required      path of the directory on the host  If the path is a symlink  it will follow the link to the real path  More info  https   kubernetes io docs concepts storage volumes hostpath        hostPath type    string       type for HostPath Volume Defaults to    More info  https   kubernetes io docs concepts storage volumes hostpath      local    LocalVolumeSource     local represents directly attached storage with node affinity     a name  LocalVolumeSource    a     Local represents directly attached storage with node affinity  Beta feature          local path    string   required      path of the full path to the volume on the node  It can be either a directory or block device  disk  partition               local fsType    string       fsType is the filesystem type to mount  It applies only when the Path is a block device  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   The default value is to auto select a filesystem if unspecified       Persistent volumes       awsElasticBlockStore    AWSElasticBlockStoreVolumeSource     awsElasticBlockStore represents an AWS Disk resource that is attached to a kubelet s host machine and then exposed to the pod  More info  https   kubernetes io docs concepts storage volumes awselasticblockstore     a name  AWSElasticBlockStoreVolumeSource    a     Represents a Persistent Disk resource in AWS       An AWS EBS disk must exist before mounting to a container  The disk must also be in the same AWS zone as the kubelet  An AWS EBS disk can only be mounted as read write once  AWS EBS volumes support ownership management and SELinux relabeling          awsElasticBlockStore volumeID    string   required      volumeID is unique ID of the persistent disk resource in AWS  Amazon EBS volume   More info  https   kubernetes io docs concepts storage volumes awselasticblockstore        awsElasticBlockStore fsType    string       fsType is the filesystem type of the volume that you want to mount  Tip  Ensure that the filesystem type is supported by the host operating system  Examples   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified  More info  https   kubernetes io docs concepts storage volumes awselasticblockstore        awsElasticBlockStore partition    int32       partition is the partition in the volume that you want to mount  If omitted  the default is to mount by volume name  Examples  For volume  dev sda1  you specify the partition as  1   Similarly  the volume partition for  dev sda is  0   or you can leave the property empty          awsElasticBlockStore readOnly    boolean       readOnly value true will force the readOnly setting in VolumeMounts  More info  https   kubernetes io docs concepts storage volumes awselasticblockstore      azureDisk    AzureDiskVolumeSource     azureDisk represents an Azure Data Disk mount on the host and bind mount to the pod      a name  AzureDiskVolumeSource    a     AzureDisk represents an Azure Data Disk mount on the host and bind mount to the pod          azureDisk diskName    string   required      diskName is the Name of the data disk in the blob storage        azureDisk diskURI    string   required      diskURI is the URI of data disk in the blob storage        azureDisk cachingMode    string       cachingMode is the Host Caching mode  None  Read Only  Read Write         azureDisk fsType    string       fsType is Filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified         azureDisk kind    string       kind expected values are Shared  multiple blob disks per storage account  Dedicated  single blob disk per storage account  Managed  azure managed data disk  only in managed availability set   defaults to shared        azureDisk readOnly    boolean       readOnly Defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts       azureFile    AzureFilePersistentVolumeSource     azureFile represents an Azure File Service mount on the host and bind mount to the pod      a name  AzureFilePersistentVolumeSource    a     AzureFile represents an Azure File Service mount on the host and bind mount to the pod          azureFile secretName    string   required      secretName is the name of secret that contains Azure Storage Account Name and Key        azureFile shareName    string   required      shareName is the azure Share Name        azureFile readOnly    boolean       readOnly defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts         azureFile secretNamespace    string       secretNamespace is the namespace of the secret that contains Azure Storage Account Name and Key default is the same as the Pod      cephfs    CephFSPersistentVolumeSource     cephFS represents a Ceph FS mount on the host that shares a pod s lifetime     a name  CephFSPersistentVolumeSource    a     Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling          cephfs monitors      string   required       Atomic  will be replaced during a merge           monitors is Required  Monitors is a collection of Ceph monitors More info  https   examples k8s io volumes cephfs README md how to use it        cephfs path    string       path is Optional  Used as the mounted root  rather than the full Ceph tree  default is          cephfs readOnly    boolean       readOnly is Optional  Defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts  More info  https   examples k8s io volumes cephfs README md how to use it        cephfs secretFile    string       secretFile is Optional  SecretFile is the path to key ring for User  default is  etc ceph user secret More info  https   examples k8s io volumes cephfs README md how to use it        cephfs secretRef    SecretReference       secretRef is Optional  SecretRef is reference to the authentication secret for User  default is empty  More info  https   examples k8s io volumes cephfs README md how to use it       a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           cephfs secretRef name    string         name is unique within a namespace to reference a secret resource           cephfs secretRef namespace    string         namespace defines the space within which the secret name must be unique         cephfs user    string       user is Optional  User is the rados user name  default is admin More info  https   examples k8s io volumes cephfs README md how to use it      cinder    CinderPersistentVolumeSource     cinder represents a cinder volume attached and mounted on kubelets host machine  More info  https   examples k8s io mysql cinder pd README md     a name  CinderPersistentVolumeSource    a     Represents a cinder volume resource in Openstack  A Cinder volume must exist before mounting to a container  The volume must also be in the same region as the kubelet  Cinder volumes support ownership management and SELinux relabeling          cinder volumeID    string   required      volumeID used to identify the volume in cinder  More info  https   examples k8s io mysql cinder pd README md        cinder fsType    string       fsType Filesystem type to mount  Must be a filesystem type supported by the host operating system  Examples   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified  More info  https   examples k8s io mysql cinder pd README md        cinder readOnly    boolean       readOnly is Optional  Defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts  More info  https   examples k8s io mysql cinder pd README md        cinder secretRef    SecretReference       secretRef is Optional  points to a secret object containing parameters used to connect to OpenStack        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           cinder secretRef name    string         name is unique within a namespace to reference a secret resource           cinder secretRef namespace    string         namespace defines the space within which the secret name must be unique       csi    CSIPersistentVolumeSource     csi represents storage that is handled by an external CSI driver  Beta feature       a name  CSIPersistentVolumeSource    a     Represents storage that is managed by an external CSI volume driver  Beta feature          csi driver    string   required      driver is the name of the driver to use for this volume  Required         csi volumeHandle    string   required      volumeHandle is the unique volume name returned by the CSI volume plugin s CreateVolume to refer to the volume on all subsequent calls  Required         csi controllerExpandSecretRef    SecretReference       controllerExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI ControllerExpandVolume call  This field is optional  and may be empty if no secret is required  If the secret object contains more than one secret  all secrets are passed        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           csi controllerExpandSecretRef name    string         name is unique within a namespace to reference a secret resource           csi controllerExpandSecretRef namespace    string         namespace defines the space within which the secret name must be unique         csi controllerPublishSecretRef    SecretReference       controllerPublishSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI ControllerPublishVolume and ControllerUnpublishVolume calls  This field is optional  and may be empty if no secret is required  If the secret object contains more than one secret  all secrets are passed        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           csi controllerPublishSecretRef name    string         name is unique within a namespace to reference a secret resource           csi controllerPublishSecretRef namespace    string         namespace defines the space within which the secret name must be unique         csi fsType    string       fsType to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs          csi nodeExpandSecretRef    SecretReference       nodeExpandSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodeExpandVolume call  This field is optional  may be omitted if no secret is required  If the secret object contains more than one secret  all secrets are passed        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           csi nodeExpandSecretRef name    string         name is unique within a namespace to reference a secret resource           csi nodeExpandSecretRef namespace    string         namespace defines the space within which the secret name must be unique         csi nodePublishSecretRef    SecretReference       nodePublishSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodePublishVolume and NodeUnpublishVolume calls  This field is optional  and may be empty if no secret is required  If the secret object contains more than one secret  all secrets are passed        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           csi nodePublishSecretRef name    string         name is unique within a namespace to reference a secret resource           csi nodePublishSecretRef namespace    string         namespace defines the space within which the secret name must be unique         csi nodeStageSecretRef    SecretReference       nodeStageSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodeStageVolume and NodeStageVolume and NodeUnstageVolume calls  This field is optional  and may be empty if no secret is required  If the secret object contains more than one secret  all secrets are passed        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           csi nodeStageSecretRef name    string         name is unique within a namespace to reference a secret resource           csi nodeStageSecretRef namespace    string         namespace defines the space within which the secret name must be unique         csi readOnly    boolean       readOnly value to pass to ControllerPublishVolumeRequest  Defaults to false  read write          csi volumeAttributes    map string string       volumeAttributes of the volume to publish       fc    FCVolumeSource     fc represents a Fibre Channel resource that is attached to a kubelet s host machine and then exposed to the pod      a name  FCVolumeSource    a     Represents a Fibre Channel volume  Fibre Channel volumes can only be mounted as read write once  Fibre Channel volumes support ownership management and SELinux relabeling          fc fsType    string       fsType is the filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified         fc lun    int32       lun is Optional  FC target lun number        fc readOnly    boolean       readOnly is Optional  Defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts         fc targetWWNs      string        Atomic  will be replaced during a merge           targetWWNs is Optional  FC target worldwide names  WWNs         fc wwids      string        Atomic  will be replaced during a merge           wwids Optional  FC volume world wide identifiers  wwids  Either wwids or combination of targetWWNs and lun must be set  but not both simultaneously       flexVolume    FlexPersistentVolumeSource     flexVolume represents a generic volume resource that is provisioned attached using an exec based plugin      a name  FlexPersistentVolumeSource    a     FlexPersistentVolumeSource represents a generic persistent volume resource that is provisioned attached using an exec based plugin          flexVolume driver    string   required      driver is the name of the driver to use for this volume         flexVolume fsType    string       fsType is the Filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   The default filesystem depends on FlexVolume script         flexVolume options    map string string       options is Optional  this field holds extra command options if any         flexVolume readOnly    boolean       readOnly is Optional  defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts         flexVolume secretRef    SecretReference       secretRef is Optional  SecretRef is reference to the secret object containing sensitive information to pass to the plugin scripts  This may be empty if no secret object is specified  If the secret object contains more than one secret  all secrets are passed to the plugin scripts        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           flexVolume secretRef name    string         name is unique within a namespace to reference a secret resource           flexVolume secretRef namespace    string         namespace defines the space within which the secret name must be unique       flocker    FlockerVolumeSource     flocker represents a Flocker volume attached to a kubelet s host machine and exposed to the pod for its usage  This depends on the Flocker control service being running     a name  FlockerVolumeSource    a     Represents a Flocker volume mounted by the Flocker agent  One and only one of datasetName and datasetUUID should be set  Flocker volumes do not support ownership management or SELinux relabeling          flocker datasetName    string       datasetName is Name of the dataset stored as metadata    name on the dataset for Flocker should be considered as deprecated        flocker datasetUUID    string       datasetUUID is the UUID of the dataset  This is unique identifier of a Flocker dataset      gcePersistentDisk    GCEPersistentDiskVolumeSource     gcePersistentDisk represents a GCE Disk resource that is attached to a kubelet s host machine and then exposed to the pod  Provisioned by an admin  More info  https   kubernetes io docs concepts storage volumes gcepersistentdisk     a name  GCEPersistentDiskVolumeSource    a     Represents a Persistent Disk resource in Google Compute Engine       A GCE PD must exist before mounting to a container  The disk must also be in the same GCE project and zone as the kubelet  A GCE PD can only be mounted as read write once or read only many times  GCE PDs support ownership management and SELinux relabeling          gcePersistentDisk pdName    string   required      pdName is unique name of the PD resource in GCE  Used to identify the disk in GCE  More info  https   kubernetes io docs concepts storage volumes gcepersistentdisk        gcePersistentDisk fsType    string       fsType is filesystem type of the volume that you want to mount  Tip  Ensure that the filesystem type is supported by the host operating system  Examples   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified  More info  https   kubernetes io docs concepts storage volumes gcepersistentdisk        gcePersistentDisk partition    int32       partition is the partition in the volume that you want to mount  If omitted  the default is to mount by volume name  Examples  For volume  dev sda1  you specify the partition as  1   Similarly  the volume partition for  dev sda is  0   or you can leave the property empty   More info  https   kubernetes io docs concepts storage volumes gcepersistentdisk        gcePersistentDisk readOnly    boolean       readOnly here will force the ReadOnly setting in VolumeMounts  Defaults to false  More info  https   kubernetes io docs concepts storage volumes gcepersistentdisk      glusterfs    GlusterfsPersistentVolumeSource     glusterfs represents a Glusterfs volume that is attached to a host and exposed to the pod  Provisioned by an admin  More info  https   examples k8s io volumes glusterfs README md     a name  GlusterfsPersistentVolumeSource    a     Represents a Glusterfs mount that lasts the lifetime of a pod  Glusterfs volumes do not support ownership management or SELinux relabeling          glusterfs endpoints    string   required      endpoints is the endpoint name that details Glusterfs topology  More info  https   examples k8s io volumes glusterfs README md create a pod        glusterfs path    string   required      path is the Glusterfs volume path  More info  https   examples k8s io volumes glusterfs README md create a pod        glusterfs endpointsNamespace    string       endpointsNamespace is the namespace that contains Glusterfs endpoint  If this field is empty  the EndpointNamespace defaults to the same namespace as the bound PVC  More info  https   examples k8s io volumes glusterfs README md create a pod        glusterfs readOnly    boolean       readOnly here will force the Glusterfs volume to be mounted with read only permissions  Defaults to false  More info  https   examples k8s io volumes glusterfs README md create a pod      iscsi    ISCSIPersistentVolumeSource     iscsi represents an ISCSI Disk resource that is attached to a kubelet s host machine and then exposed to the pod  Provisioned by an admin      a name  ISCSIPersistentVolumeSource    a     ISCSIPersistentVolumeSource represents an ISCSI disk  ISCSI volumes can only be mounted as read write once  ISCSI volumes support ownership management and SELinux relabeling          iscsi iqn    string   required      iqn is Target iSCSI Qualified Name         iscsi lun    int32   required      lun is iSCSI Target Lun number         iscsi targetPortal    string   required      targetPortal is iSCSI Target Portal  The Portal is either an IP or ip addr port if the port is other than default  typically TCP ports 860 and 3260          iscsi chapAuthDiscovery    boolean       chapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication        iscsi chapAuthSession    boolean       chapAuthSession defines whether support iSCSI Session CHAP authentication        iscsi fsType    string       fsType is the filesystem type of the volume that you want to mount  Tip  Ensure that the filesystem type is supported by the host operating system  Examples   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified  More info  https   kubernetes io docs concepts storage volumes iscsi        iscsi initiatorName    string       initiatorName is the custom iSCSI Initiator Name  If initiatorName is specified with iscsiInterface simultaneously  new iSCSI interface   target portal    volume name  will be created for the connection         iscsi iscsiInterface    string       iscsiInterface is the interface Name that uses an iSCSI transport  Defaults to  default   tcp          iscsi portals      string        Atomic  will be replaced during a merge           portals is the iSCSI Target Portal List  The Portal is either an IP or ip addr port if the port is other than default  typically TCP ports 860 and 3260          iscsi readOnly    boolean       readOnly here will force the ReadOnly setting in VolumeMounts  Defaults to false         iscsi secretRef    SecretReference       secretRef is the CHAP Secret for iSCSI target and initiator authentication       a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           iscsi secretRef name    string         name is unique within a namespace to reference a secret resource           iscsi secretRef namespace    string         namespace defines the space within which the secret name must be unique       nfs    NFSVolumeSource     nfs represents an NFS mount on the host  Provisioned by an admin  More info  https   kubernetes io docs concepts storage volumes nfs     a name  NFSVolumeSource    a     Represents an NFS mount that lasts the lifetime of a pod  NFS volumes do not support ownership management or SELinux relabeling          nfs path    string   required      path that is exported by the NFS server  More info  https   kubernetes io docs concepts storage volumes nfs        nfs server    string   required      server is the hostname or IP address of the NFS server  More info  https   kubernetes io docs concepts storage volumes nfs        nfs readOnly    boolean       readOnly here will force the NFS export to be mounted with read only permissions  Defaults to false  More info  https   kubernetes io docs concepts storage volumes nfs      photonPersistentDisk    PhotonPersistentDiskVolumeSource     photonPersistentDisk represents a PhotonController persistent disk attached and mounted on kubelets host machine     a name  PhotonPersistentDiskVolumeSource    a     Represents a Photon Controller persistent disk resource          photonPersistentDisk pdID    string   required      pdID is the ID that identifies Photon Controller persistent disk        photonPersistentDisk fsType    string       fsType is the filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified       portworxVolume    PortworxVolumeSource     portworxVolume represents a portworx volume attached and mounted on kubelets host machine     a name  PortworxVolumeSource    a     PortworxVolumeSource represents a Portworx volume resource          portworxVolume volumeID    string   required      volumeID uniquely identifies a Portworx volume        portworxVolume fsType    string       fSType represents the filesystem type to mount Must be a filesystem type supported by the host operating system  Ex   ext4    xfs   Implicitly inferred to be  ext4  if unspecified         portworxVolume readOnly    boolean       readOnly defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts       quobyte    QuobyteVolumeSource     quobyte represents a Quobyte mount on the host that shares a pod s lifetime     a name  QuobyteVolumeSource    a     Represents a Quobyte mount that lasts the lifetime of a pod  Quobyte volumes do not support ownership management or SELinux relabeling          quobyte registry    string   required      registry represents a single or multiple Quobyte Registry services specified as a string as host port pair  multiple entries are separated with commas  which acts as the central registry for volumes        quobyte volume    string   required      volume is a string that references an already created Quobyte volume by name         quobyte group    string       group to map volume access to Default is no group        quobyte readOnly    boolean       readOnly here will force the Quobyte volume to be mounted with read only permissions  Defaults to false         quobyte tenant    string       tenant owning the given Quobyte volume in the Backend Used with dynamically provisioned Quobyte volumes  value is set by the plugin        quobyte user    string       user to map volume access to Defaults to serivceaccount user      rbd    RBDPersistentVolumeSource     rbd represents a Rados Block Device mount on the host that shares a pod s lifetime  More info  https   examples k8s io volumes rbd README md     a name  RBDPersistentVolumeSource    a     Represents a Rados Block Device mount that lasts the lifetime of a pod  RBD volumes support ownership management and SELinux relabeling          rbd image    string   required      image is the rados image name  More info  https   examples k8s io volumes rbd README md how to use it        rbd monitors      string   required       Atomic  will be replaced during a merge           monitors is a collection of Ceph monitors  More info  https   examples k8s io volumes rbd README md how to use it        rbd fsType    string       fsType is the filesystem type of the volume that you want to mount  Tip  Ensure that the filesystem type is supported by the host operating system  Examples   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified  More info  https   kubernetes io docs concepts storage volumes rbd        rbd keyring    string       keyring is the path to key ring for RBDUser  Default is  etc ceph keyring  More info  https   examples k8s io volumes rbd README md how to use it        rbd pool    string       pool is the rados pool name  Default is rbd  More info  https   examples k8s io volumes rbd README md how to use it        rbd readOnly    boolean       readOnly here will force the ReadOnly setting in VolumeMounts  Defaults to false  More info  https   examples k8s io volumes rbd README md how to use it        rbd secretRef    SecretReference       secretRef is name of the authentication secret for RBDUser  If provided overrides keyring  Default is nil  More info  https   examples k8s io volumes rbd README md how to use it       a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           rbd secretRef name    string         name is unique within a namespace to reference a secret resource           rbd secretRef namespace    string         namespace defines the space within which the secret name must be unique         rbd user    string       user is the rados user name  Default is admin  More info  https   examples k8s io volumes rbd README md how to use it      scaleIO    ScaleIOPersistentVolumeSource     scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes      a name  ScaleIOPersistentVolumeSource    a     ScaleIOPersistentVolumeSource represents a persistent ScaleIO volume         scaleIO gateway    string   required      gateway is the host address of the ScaleIO API Gateway         scaleIO secretRef    SecretReference   required      secretRef references to the secret for ScaleIO user and other sensitive information  If this is not provided  Login operation will fail        a name  SecretReference    a       SecretReference represents a Secret Reference  It has enough information to retrieve secret in any namespace           scaleIO secretRef name    string         name is unique within a namespace to reference a secret resource           scaleIO secretRef namespace    string         namespace defines the space within which the secret name must be unique         scaleIO system    string   required      system is the name of the storage system as configured in ScaleIO         scaleIO fsType    string       fsType is the filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   Default is  xfs         scaleIO protectionDomain    string       protectionDomain is the name of the ScaleIO Protection Domain for the configured storage         scaleIO readOnly    boolean       readOnly defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts         scaleIO sslEnabled    boolean       sslEnabled is the flag to enable disable SSL communication with Gateway  default false        scaleIO storageMode    string       storageMode indicates whether the storage for a volume should be ThickProvisioned or ThinProvisioned  Default is ThinProvisioned         scaleIO storagePool    string       storagePool is the ScaleIO Storage Pool associated with the protection domain         scaleIO volumeName    string       volumeName is the name of a volume already created in the ScaleIO system that is associated with this volume source       storageos    StorageOSPersistentVolumeSource     storageOS represents a StorageOS volume that is attached to the kubelet s host machine and mounted into the pod More info  https   examples k8s io volumes storageos README md     a name  StorageOSPersistentVolumeSource    a     Represents a StorageOS persistent volume resource          storageos fsType    string       fsType is the filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified         storageos readOnly    boolean       readOnly defaults to false  read write   ReadOnly here will force the ReadOnly setting in VolumeMounts         storageos secretRef     a href    ObjectReference  a        secretRef specifies the secret to use for obtaining the StorageOS API credentials   If not specified  default values will be attempted         storageos volumeName    string       volumeName is the human readable name of the StorageOS volume   Volume names are only unique within a namespace         storageos volumeNamespace    string       volumeNamespace specifies the scope of the volume within StorageOS   If no namespace is specified then the Pod s namespace will be used   This allows the Kubernetes name scoping to be mirrored within StorageOS for tighter integration  Set VolumeName to any name to override the default behaviour  Set to  default  if you are not using namespaces within StorageOS  Namespaces that do not pre exist within StorageOS will be created       vsphereVolume    VsphereVirtualDiskVolumeSource     vsphereVolume represents a vSphere volume attached and mounted on kubelets host machine     a name  VsphereVirtualDiskVolumeSource    a     Represents a vSphere volume resource          vsphereVolume volumePath    string   required      volumePath is the path that identifies vSphere volume vmdk        vsphereVolume fsType    string       fsType is filesystem type to mount  Must be a filesystem type supported by the host operating system  Ex   ext4    xfs    ntfs   Implicitly inferred to be  ext4  if unspecified         vsphereVolume storagePolicyID    string       storagePolicyID is the storage Policy Based Management  SPBM  profile ID associated with the StoragePolicyName         vsphereVolume storagePolicyName    string       storagePolicyName is the storage Policy Based Management  SPBM  profile name        PersistentVolumeStatus   PersistentVolumeStatus   PersistentVolumeStatus is the current status of a persistent volume    hr       lastPhaseTransitionTime    Time     lastPhaseTransitionTime is the time the phase transitioned from one to another and automatically resets to current time everytime a volume phase transitions      a name  Time    a     Time is a wrapper around time Time which supports correct marshaling to YAML and JSON   Wrappers are provided for many of the factory methods that the time package offers        message    string     message is a human readable message indicating details about why the volume is in this state       phase    string     phase indicates if a volume is available  bound to a claim  or released by a claim  More info  https   kubernetes io docs concepts storage persistent volumes phase      reason    string     reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI          PersistentVolumeList   PersistentVolumeList   PersistentVolumeList is a list of PersistentVolume items    hr       apiVersion    v1       kind    PersistentVolumeList       metadata     a href    ListMeta  a      Standard list metadata  More info  https   git k8s io community contributors devel sig architecture api conventions md types kinds      items       a href    PersistentVolume  a    required    items is a list of persistent volumes  More info  https   kubernetes io docs concepts storage persistent volumes         Operations   Operations      hr             get  read the specified PersistentVolume       HTTP Request  GET  api v1 persistentvolumes  name        Parameters       name     in path    string  required    name of the PersistentVolume       pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  401  Unauthorized        get  read status of the specified PersistentVolume       HTTP Request  GET  api v1 persistentvolumes  name  status       Parameters       name     in path    string  required    name of the PersistentVolume       pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  401  Unauthorized        list  list or watch objects of kind PersistentVolume       HTTP Request  GET  api v1 persistentvolumes       Parameters       allowWatchBookmarks     in query    boolean     a href    allowWatchBookmarks  a        continue     in query    string     a href    continue  a        fieldSelector     in query    string     a href    fieldSelector  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a        watch     in query    boolean     a href    watch  a          Response   200   a href    PersistentVolumeList  a    OK  401  Unauthorized        create  create a PersistentVolume       HTTP Request  POST  api v1 persistentvolumes       Parameters       body     a href    PersistentVolume  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  201   a href    PersistentVolume  a    Created  202   a href    PersistentVolume  a    Accepted  401  Unauthorized        update  replace the specified PersistentVolume       HTTP Request  PUT  api v1 persistentvolumes  name        Parameters       name     in path    string  required    name of the PersistentVolume       body     a href    PersistentVolume  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  201   a href    PersistentVolume  a    Created  401  Unauthorized        update  replace status of the specified PersistentVolume       HTTP Request  PUT  api v1 persistentvolumes  name  status       Parameters       name     in path    string  required    name of the PersistentVolume       body     a href    PersistentVolume  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  201   a href    PersistentVolume  a    Created  401  Unauthorized        patch  partially update the specified PersistentVolume       HTTP Request  PATCH  api v1 persistentvolumes  name        Parameters       name     in path    string  required    name of the PersistentVolume       body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  201   a href    PersistentVolume  a    Created  401  Unauthorized        patch  partially update status of the specified PersistentVolume       HTTP Request  PATCH  api v1 persistentvolumes  name  status       Parameters       name     in path    string  required    name of the PersistentVolume       body     a href    Patch  a   required           dryRun     in query    string     a href    dryRun  a        fieldManager     in query    string     a href    fieldManager  a        fieldValidation     in query    string     a href    fieldValidation  a        force     in query    boolean     a href    force  a        pretty     in query    string     a href    pretty  a          Response   200   a href    PersistentVolume  a    OK  201   a href    PersistentVolume  a    Created  401  Unauthorized        delete  delete a PersistentVolume       HTTP Request  DELETE  api v1 persistentvolumes  name        Parameters       name     in path    string  required    name of the PersistentVolume       body     a href    DeleteOptions  a            dryRun     in query    string     a href    dryRun  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a          Response   200   a href    PersistentVolume  a    OK  202   a href    PersistentVolume  a    Accepted  401  Unauthorized        deletecollection  delete collection of PersistentVolume       HTTP Request  DELETE  api v1 persistentvolumes       Parameters       body     a href    DeleteOptions  a            continue     in query    string     a href    continue  a        dryRun     in query    string     a href    dryRun  a        fieldSelector     in query    string     a href    fieldSelector  a        gracePeriodSeconds     in query    integer     a href    gracePeriodSeconds  a        labelSelector     in query    string     a href    labelSelector  a        limit     in query    integer     a href    limit  a        pretty     in query    string     a href    pretty  a        propagationPolicy     in query    string     a href    propagationPolicy  a        resourceVersion     in query    string     a href    resourceVersion  a        resourceVersionMatch     in query    string     a href    resourceVersionMatch  a        sendInitialEvents     in query    boolean     a href    sendInitialEvents  a        timeoutSeconds     in query    integer     a href    timeoutSeconds  a          Response   200   a href    Status  a    OK  401  Unauthorized