持久卷

PersistentVolume (PV) 是由管理员配置的存储资源。

apiVersion: v1

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

持久卷

PersistentVolume (PV) 是由管理员配置的存储资源。它类似于节点。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes

PersistentVolumeSpec

PersistentVolumeSpec 是持久卷的规范。

  • accessModes ([]string)

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

  • capacity (map[string]Quantity)

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

  • claimRef (ObjectReference)

    claimRef 是 PersistentVolume 和 PersistentVolumeClaim 之间双向绑定的一部分。在绑定时应为非空。claim.VolumeName 是 PV 和 PVC 之间的权威绑定。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#binding

  • mountOptions ([]string)

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

  • nodeAffinity (VolumeNodeAffinity)

    nodeAffinity 定义了限制此卷可以从哪些节点访问的约束。此字段会影响使用此卷的 Pod 的调度。

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

    • nodeAffinity.required (NodeSelector)

      required 指定必须满足的硬节点约束。

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

      • nodeAffinity.required.nodeSelectorTerms ([]NodeSelectorTerm), required

        Required. 节点选择器术语列表。这些术语是 ORed 的。

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

        • nodeAffinity.required.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)

          节点标签的节点选择器需求列表。

        • nodeAffinity.required.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)

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

  • persistentVolumeReclaimPolicy (string)

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

  • storageClassName (string)

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

  • volumeMode (string)

    volumeMode 定义卷是打算用于格式化的文件系统还是保持原始块状态。如果 spec 中未包含 Filesystem，则表示为 Filesystem。

Local

  • hostPath (HostPathVolumeSource)

    hostPath 表示主机上的目录。由开发人员或测试人员配置。这仅适用于单节点开发和测试！主机上的存储不受任何方式支持，并且在多节点集群中将无法工作。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#hostpath

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

  • local (LocalVolumeSource)

    local 表示具有节点亲和性的直接连接的存储

    Local 表示具有节点亲和性的直接连接的存储（Beta 功能）

    • local.path (string), required

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

    • local.fsType (string)

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

持久卷

  • awsElasticBlockStore (AWSElasticBlockStoreVolumeSource)

    awsElasticBlockStore 表示连接到 kubelet 的主机并随后暴露给 Pod 的 AWS 磁盘资源。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#awselasticblockstore

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

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

  • azureDisk (AzureDiskVolumeSource)

    azureDisk 表示主机上的 Azure 数据磁盘挂载，并绑定挂载到 Pod。

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

    • azureDisk.diskName (string), required

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

    • azureDisk.diskURI (string), required

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

    • azureDisk.cachingMode (string)

      cachingMode 是主机缓存模式：None、ReadOnly、ReadWrite。

    • azureDisk.fsType (string)

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

    • azureDisk.kind (string)

      kind 预期值为 Shared：每个存储帐户多个 Blob 磁盘 Dedicated：每个存储帐户单个 Blob 磁盘 Managed：azure 管理的数据磁盘（仅在托管可用性集中）。默认为 shared

    • azureDisk.readOnly (boolean)

      readOnly 默认值为 false（读/写）。这里 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

  • azureFile (AzureFilePersistentVolumeSource)

    azureFile 表示主机上的 Azure 文件服务挂载，并绑定挂载到 Pod。

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

    • azureFile.secretName (string), required

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

    • azureFile.shareName (string), required

      shareName 是 azure 共享名称

    • azureFile.readOnly (boolean)

      readOnly 默认值为 false（读/写）。这里 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

    • azureFile.secretNamespace (string)

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

  • cephfs (CephFSPersistentVolumeSource)

    cephFS 表示主机上的 Ceph FS 挂载，它与 Pod 的生命周期共享。

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

  • cinder (CinderPersistentVolumeSource)

    cinder 代表一个连接到 kubelet 主机并挂载到容器中的 cinder 卷。更多信息：https://examples.k8s.io/mysql-cinder-pd/README.md

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

    • cinder.volumeID (string), 必需

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

    • cinder.fsType (string)

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

    • cinder.readOnly (boolean)

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

    • cinder.secretRef (SecretReference)

      secretRef 可选：指向包含用于连接 OpenStack 的参数的 secret 对象。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • cinder.secretRef.name (string)

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

      • cinder.secretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

  • csi (CSIPersistentVolumeSource)

    csi 代表由外部 CSI 驱动程序处理的存储（Beta 功能）。

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

    • csi.driver (string), 必需

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

    • csi.volumeHandle (string), 必需

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

    • csi.controllerExpandSecretRef (SecretReference)

      controllerExpandSecretRef 是指向包含敏感信息的 secret 对象的引用，这些信息将传递给 CSI 驱动程序以完成 CSI ControllerExpandVolume 调用。此字段是可选的，如果不需要 secret，则可以为空。如果 secret 对象包含多个 secret，则所有 secret 都将被传递。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • csi.controllerExpandSecretRef.name (string)

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

      • csi.controllerExpandSecretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

    • csi.controllerPublishSecretRef (SecretReference)

      controllerPublishSecretRef 是指向包含敏感信息的 secret 对象的引用，这些信息将传递给 CSI 驱动程序以完成 CSI ControllerPublishVolume 和 ControllerUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可以为空。如果 secret 对象包含多个 secret，则所有 secret 都将被传递。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • csi.controllerPublishSecretRef.name (string)

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

      • csi.controllerPublishSecretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

    • csi.fsType (string)

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

    • csi.nodeExpandSecretRef (SecretReference)

      nodeExpandSecretRef 是指向包含敏感信息的 secret 对象的引用，这些信息将传递给 CSI 驱动程序以完成 CSI NodeExpandVolume 调用。这是一个 beta 字段，默认情况下由 CSINodeExpandSecret 功能开关启用。此字段是可选的，如果不需要 secret，可以省略。如果 secret 对象包含多个 secret，则所有 secret 都将被传递。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • csi.nodeExpandSecretRef.name (string)

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

      • csi.nodeExpandSecretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

    • csi.nodePublishSecretRef (SecretReference)

      nodePublishSecretRef 是指向包含敏感信息的 secret 对象的引用，这些信息将传递给 CSI 驱动程序以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可以为空。如果 secret 对象包含多个 secret，则所有 secret 都将被传递。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • csi.nodePublishSecretRef.name (string)

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

      • csi.nodePublishSecretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

    • csi.nodeStageSecretRef (SecretReference)

      nodeStageSecretRef 是指向包含敏感信息的 secret 对象的引用，这些信息将传递给 CSI 驱动程序以完成 CSI NodeStageVolume 和 NodeStageVolume 以及 NodeUnstageVolume 调用。此字段是可选的，如果不需要 secret，则可以为空。如果 secret 对象包含多个 secret，则所有 secret 都将被传递。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • csi.nodeStageSecretRef.name (string)

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

      • csi.nodeStageSecretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

    • csi.readOnly (boolean)

      readOnly 传递给 ControllerPublishVolumeRequest 的值。默认为 false（读写）。

    • csi.volumeAttributes (map[string]string)

      要发布的卷的 volumeAttributes。

  • fc (FCVolumeSource)

    fc 代表一个连接到 kubelet 主机并暴露给 pod 的 Fibre Channel 资源。

    代表一个 Fibre Channel 卷。Fibre Channel 卷只能以读写方式挂载一次。Fibre Channel 卷支持所有权管理和 SELinux 重新标记。

    • fc.fsType (string)

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

    • fc.lun (int32)

      lun 可选：FC 目标 lun 编号

    • fc.readOnly (boolean)

      readOnly 可选：默认值为 false（读写）。这里的 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

    • fc.targetWWNs ([]string)

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

    • fc.wwids ([]string)

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

  • flexVolume (FlexPersistentVolumeSource)

    flexVolume 代表一个使用基于 exec 的插件进行配置/附加的通用卷资源。

    FlexPersistentVolumeSource 代表一个使用基于 exec 的插件进行配置/附加的通用持久卷资源。

    • flexVolume.driver (string), 必需

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

    • flexVolume.fsType (string)

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

    • flexVolume.options (map[string]string)

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

    • flexVolume.readOnly (boolean)

      readOnly 可选：默认为 false（读写）。这里的 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

    • flexVolume.secretRef (SecretReference)

      secretRef 可选：SecretRef 是指向包含要传递给插件脚本的敏感信息的 secret 对象的引用。如果未指定 secret 对象，则可以为空。如果 secret 对象包含多个 secret，则所有 secret 都将传递给插件脚本。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • flexVolume.secretRef.name (string)

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

      • flexVolume.secretRef.namespace (string)

        namespace 定义了 secret name 必须唯一的空间。

  • flocker (FlockerVolumeSource)

    flocker 代表一个连接到 kubelet 主机并暴露给 pod 以供其使用的 Flocker 卷。这取决于 Flocker 控制服务是否正在运行

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

    • flocker.datasetName (string)

      datasetName 是存储为元数据 -> name 的数据集的名称，Flocker 上的数据集应被视为已弃用

    • flocker.datasetUUID (string)

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

  • gcePersistentDisk (GCEPersistentDiskVolumeSource)

    gcePersistentDisk 代表一个连接到 kubelet 主机并暴露给 pod 的 GCE 磁盘资源。由管理员配置。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#gcepersistentdisk

    *代表 Google Compute Engine 中的一个持久磁盘资源。

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

  • glusterfs (GlusterfsPersistentVolumeSource)

    glusterfs 代表一个连接到主机并暴露给 pod 的 Glusterfs 卷。由管理员配置。更多信息：https://examples.k8s.io/volumes/glusterfs/README.md

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

  • iscsi (ISCSIPersistentVolumeSource)

    iscsi 代表一个 ISCSI 磁盘资源，它连接到 kubelet 的主机，然后暴露给 pod。 由管理员配置。

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

    • iscsi.iqn (字符串), 必填

      iqn 是目标 ISCSI 认证名称。

    • iscsi.lun (int32), 必填

      lun 是 iSCSI 目标 Lun 编号。

    • iscsi.targetPortal (字符串), 必填

      targetPortal 是 iSCSI 目标 Portal。 Portal 是一个 IP 地址，或者如果端口不是默认端口（通常是 TCP 端口 860 和 3260），则是 ip_addr:port。

    • iscsi.chapAuthDiscovery (布尔值)

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

    • iscsi.chapAuthSession (布尔值)

      chapAuthSession 定义是否支持 iSCSI 会话 CHAP 身份验证。

    • iscsi.fsType (字符串)

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

    • iscsi.initiatorName (字符串)

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

    • iscsi.iscsiInterface (字符串)

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

    • iscsi.portals ([]字符串)

      portals 是 iSCSI 目标 Portal 列表。 Portal 是一个 IP 地址，或者如果端口不是默认端口（通常是 TCP 端口 860 和 3260），则是 ip_addr:port。

    • iscsi.readOnly (布尔值)

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

    • iscsi.secretRef (SecretReference)

      secretRef 是用于 iSCSI 目标和发起程序身份验证的 CHAP 密钥。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • iscsi.secretRef.name (字符串)

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

      • iscsi.secretRef.namespace (字符串)

        namespace 定义了 secret name 必须唯一的空间。

  • nfs (NFSVolumeSource)

    nfs 代表主机上的 NFS 挂载。 由管理员配置。 更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes#nfs

    代表一个与 Pod 存在周期相同的 NFS 挂载。 NFS 卷不支持所有权管理或 SELinux 重新标记。

  • photonPersistentDisk (PhotonPersistentDiskVolumeSource)

    photonPersistentDisk 代表一个 PhotonController 持久磁盘，它连接并挂载到 kubelets 的主机。

    代表一个 Photon Controller 持久磁盘资源。

    • photonPersistentDisk.pdID (字符串), 必填

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

    • photonPersistentDisk.fsType (字符串)

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

  • portworxVolume (PortworxVolumeSource)

    portworxVolume 代表一个 portworx 卷，它连接并挂载到 kubelets 的主机。

    PortworxVolumeSource 代表一个 Portworx 卷资源。

    • portworxVolume.volumeID (字符串), 必填

      volumeID 唯一标识一个 Portworx 卷。

    • portworxVolume.fsType (字符串)

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

    • portworxVolume.readOnly (布尔值)

      readOnly 默认值为 false（读/写）。这里 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

  • quobyte (QuobyteVolumeSource)

    quobyte 代表主机上的 Quobyte 挂载，它与 Pod 的生命周期共享。

    代表一个与 Pod 存在周期相同的 Quobyte 挂载。 Quobyte 卷不支持所有权管理或 SELinux 重新标记。

    • quobyte.registry (字符串), 必填

      registry 代表一个或多个 Quobyte 注册服务，指定为字符串，格式为 host:port 对（多个条目用逗号分隔），作为卷的中央注册中心。

    • quobyte.volume (字符串), 必填

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

    • quobyte.group (字符串)

      将卷访问映射到组。 默认情况下没有组。

    • quobyte.readOnly (布尔值)

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

    • quobyte.tenant (字符串)

      拥有后端中给定 Quobyte 卷的租户。 与动态配置的 Quobyte 卷一起使用，值由插件设置。

    • quobyte.user (字符串)

      将卷访问映射到用户。 默认值为 serivceaccount 用户。

  • rbd (RBDPersistentVolumeSource)

    rbd 代表主机上的 Rados 块设备挂载，它与 Pod 的生命周期共享。 更多信息：https://examples.k8s.io/volumes/rbd/README.md

    代表一个与 Pod 存在周期相同的 Rados 块设备挂载。 RBD 卷支持所有权管理和 SELinux 重新标记。

  • scaleIO (ScaleIOPersistentVolumeSource)

    scaleIO 代表一个 ScaleIO 持久卷，它连接并挂载到 Kubernetes 节点。

    ScaleIOPersistentVolumeSource 代表一个持久 ScaleIO 卷。

    • scaleIO.gateway (字符串), 必填

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

    • scaleIO.secretRef (SecretReference), 必填

      secretRef 引用 ScaleIO 用户和其他敏感信息的密钥。 如果未提供，则登录操作将失败。

      SecretReference 代表一个 Secret 引用。它包含足够的的信息，以便在任何命名空间中检索 secret

      • scaleIO.secretRef.name (字符串)

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

      • scaleIO.secretRef.namespace (字符串)

        namespace 定义了 secret name 必须唯一的空间。

    • scaleIO.system (字符串), 必填

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

    • scaleIO.fsType (字符串)

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

    • scaleIO.protectionDomain (字符串)

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

    • scaleIO.readOnly (布尔值)

      readOnly 默认值为 false（读/写）。这里 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

    • scaleIO.sslEnabled (布尔值)

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

    • scaleIO.storageMode (字符串)

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

    • scaleIO.storagePool (字符串)

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

    • scaleIO.volumeName (字符串)

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

  • storageos (StorageOSPersistentVolumeSource)

    storageOS 代表一个 StorageOS 卷，它连接到 kubelet 的主机，并挂载到 pod 中。 更多信息：https://examples.k8s.io/volumes/storageos/README.md

    代表一个 StorageOS 持久卷资源。

    • storageos.fsType (字符串)

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

    • storageos.readOnly (布尔值)

      readOnly 默认值为 false（读/写）。这里 ReadOnly 将强制在 VolumeMounts 中设置 ReadOnly。

    • storageos.secretRef (ObjectReference)

      secretRef 指定用于获取 StorageOS API 凭据的密钥。 如果未指定，将尝试使用默认值。

    • storageos.volumeName (字符串)

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

    • storageos.volumeNamespace (字符串)

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

  • vsphereVolume (VsphereVirtualDiskVolumeSource)

    vsphereVolume 代表一个连接并挂载到 kubelets 主机的 vSphere 卷。

    代表一个 vSphere 卷资源。

    • vsphereVolume.volumePath (字符串), 必填

      volumePath 是标识 vSphere 卷 vmdk 的路径。

    • vsphereVolume.fsType (字符串)

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

    • vsphereVolume.storagePolicyID (字符串)

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

    • vsphereVolume.storagePolicyName (字符串)

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

PersistentVolumeStatus

PersistentVolumeStatus 是持久卷的当前状态。

  • lastPhaseTransitionTime (时间)

    lastPhaseTransitionTime 是阶段从一个阶段转换到另一个阶段的时间，并且每次卷阶段转换时都会自动重置为当前时间。 这是一个 alpha 字段，需要启用 PersistentVolumeLastPhaseTransitionTime 特性。

    Time 是 time.Time 的包装器，支持正确地编组到 YAML 和 JSON 中。 包装器针对 time 包提供的许多工厂方法提供。

  • message (字符串)

    message 是一个人类可读的消息，指示有关卷处于此状态的原因的详细信息。

  • 阶段 (字符串)

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

  • 原因 (字符串)

    原因是一个简短的驼峰式字符串，描述任何失败，旨在用于机器解析并在 CLI 中整洁地显示。

PersistentVolumeList

PersistentVolumeList 是 PersistentVolume 项目的列表。

操作

get 读取指定的 PersistentVolume

HTTP 请求

GET /api/v1/persistentvolumes/{name}

参数

  • 名称 (在路径中): 字符串，必需

    PersistentVolume 的名称

  • 漂亮 (在查询中): 字符串

    漂亮

响应

200 (PersistentVolume): 确定

401: 未授权

get 读取指定 PersistentVolume 的状态

HTTP 请求

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

参数

  • 名称 (在路径中): 字符串，必需

    PersistentVolume 的名称

  • 漂亮 (在查询中): 字符串

    漂亮

响应

200 (PersistentVolume): 确定

401: 未授权

list 列出或观察 PersistentVolume 类型的对象

HTTP 请求

GET /api/v1/persistentvolumes

参数

响应

200 (PersistentVolumeList): 确定

401: 未授权

create 创建一个 PersistentVolume

HTTP 请求

POST /api/v1/persistentvolumes

参数

响应

200 (PersistentVolume): 确定

201 (PersistentVolume): 已创建

202 (PersistentVolume): 已接受

401: 未授权

update 替换指定的 PersistentVolume

HTTP 请求

PUT /api/v1/persistentvolumes/{name}

参数

  • 名称 (在路径中): 字符串，必需

    PersistentVolume 的名称

  • 主体: PersistentVolume, 必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • 漂亮 (在查询中): 字符串

    漂亮

响应

200 (PersistentVolume): 确定

201 (PersistentVolume): 已创建

401: 未授权

update 替换指定 PersistentVolume 的状态

HTTP 请求

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

参数

  • 名称 (在路径中): 字符串，必需

    PersistentVolume 的名称

  • 主体: PersistentVolume, 必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • 漂亮 (在查询中): 字符串

    漂亮

响应

200 (PersistentVolume): 确定

201 (PersistentVolume): 已创建

401: 未授权

patch 部分更新指定的 PersistentVolume

HTTP 请求

PATCH /api/v1/persistentvolumes/{name}

参数

  • 名称 (在路径中): 字符串，必需

    PersistentVolume 的名称

  • 主体: Patch, 必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • 强制 (在查询中): 布尔值

    强制

  • 漂亮 (在查询中): 字符串

    漂亮

响应

200 (PersistentVolume): 确定

201 (PersistentVolume): 已创建

401: 未授权

patch 部分更新指定 PersistentVolume 的状态

HTTP 请求

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

参数

  • 名称 (在路径中): 字符串，必需

    PersistentVolume 的名称

  • 主体: Patch, 必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • 强制 (在查询中): 布尔值

    强制

  • 漂亮 (在查询中): 字符串

    漂亮

响应

200 (PersistentVolume): 确定

201 (PersistentVolume): 已创建

401: 未授权

delete 删除一个 PersistentVolume

HTTP 请求

DELETE /api/v1/persistentvolumes/{name}

参数

响应

200 (PersistentVolume): 确定

202 (PersistentVolume): 已接受

401: 未授权

deletecollection 删除 PersistentVolume 的集合

HTTP 请求

DELETE /api/v1/persistentvolumes

参数

响应

200 (Status): 确定

401: 未授权

此页面是自动生成的。

如果您计划报告有关此页面的问题，请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间：2023 年 7 月 26 日下午 1:45 PST: 生成的內容 (1e2ed88743)