第 5 章 PersistentVolumeClaim [v1]

描述: PersistentVolumeClaim 是用户对持久性卷的请求并声明
类型: 对象

5.1. 规格

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`对象`	PersistentVolumeClaimSpec 描述了存储设备的通用属性，并允许 Source 用于特定于供应商的属性
`status`	`对象`	PersistentVolumeClaimStatus 是持久性卷声明的当前状态。

5.1.1. .spec

描述: PersistentVolumeClaimSpec 描述了存储设备的通用属性，并允许 Source 用于特定于供应商的属性
类型: object

属性	类型	描述
`accessModes`	`数组（字符串）`	accessModes 包含卷应具有所需的访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
`dataSource`	`对象`	TypedLocalObjectReference 包含足够信息，以便您在同一命名空间中找到类型引用的对象。
`dataSourceRef`	`对象`	TypedLocalObjectReference 包含足够信息，以便您在同一命名空间中找到类型引用的对象。
`资源`	`对象`	ResourceRequirements 描述了计算资源要求。
`selector`	`LabelSelector`	selector 是要考虑绑定的卷的标签查询。
`storageClassName`	`string`	storageClassName 是声明所需的 StorageClass 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
`volumeMode`	`字符串`	volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时，文件系统的值会被表示。
`volumeName`	`string`	volumeName 是对此声明支持的 PersistentVolume 的绑定引用。

5.1.2. .spec.dataSource

描述

TypedLocalObjectReference 包含足够信息，以便您在同一命名空间中找到类型引用的对象。

类型

object

必填

kind
name

属性	类型	描述
`apiGroup`	`字符串`	APIGroup 是所引用资源的组。如果没有指定 APIGroup，则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型，需要 APIGroup。
`kind`	`字符串`	kind 是被引用的资源类型
`name`	`字符串`	name 是被引用的资源的名称

5.1.3. .spec.dataSourceRef

描述

TypedLocalObjectReference 包含足够信息，以便您在同一命名空间中找到类型引用的对象。

类型

object

必填

kind
name

属性	类型	描述
`apiGroup`	`字符串`	APIGroup 是所引用资源的组。如果没有指定 APIGroup，则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型，需要 APIGroup。
`kind`	`字符串`	kind 是被引用的资源类型
`name`	`字符串`	name 是被引用的资源的名称

5.1.4. .spec.resources

描述: ResourceRequirements 描述了计算资源要求。
类型: object

属性	类型	描述
`limits`	`对象（数量）`	限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
`requests`	`对象（数量）`	Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

5.1.5. .status

描述: PersistentVolumeClaimStatus 是持久性卷声明的当前状态。
类型: object

属性	类型	描述
`accessModes`	`数组（字符串）`	accessModes 包含 PVC 支持的卷的实际访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
`allocatedResources`	`对象（数量）`	allocatedResources 是 AllocatedResources 中的存储资源跟踪分配给 PVC 的容量。当请求卷扩展操作时，它可能大于实际容量。对于存储配额，使用来自 allocatedResources 和 PVC.spec.resources 的值。如果没有设置 allocatedResources，则单独使用 PVC.spec.resources 进行配额计算。如果卷扩展容量请求较低，则只有当实际卷容量相等或低于请求的容量时，才会降低 allocatedResources。这是一个 alpha 字段，需要启用 RecoverVolumeExpansionFailure 功能。
`capacity`	`对象（数量）`	capacity 代表底层卷的实际资源。
`conditions`	`数组`	条件是持久性卷声明的当前条件。如果底层持久性卷被调整大小，则条件将设置为 'ResizeStarted'。
`conditions[]`	`对象`	PersistentVolumeClaimCondition contails 有关 pvc 状态的详细信息
`phase`	`string`	phase 代表 PersistentVolumeClaim 的当前阶段。可能枚举值： - 用于绑定的 PersistentVolumeClaim 的 `"Bound "` - 用于丢失其底层 PersistentVolume 的 PersistentVolumeClaim。这个声明绑定到 PersistentVolume，这个卷不再存在，并会丢失它的所有数据。- 用于尚未绑定的 PersistentVolumeClaim 的 `"Pending"`
`resizeStatus`	`string`	resizeStatus 存储调整大小操作的状态。默认不会设置 ResizeStatus，但当扩展完成 resizeStatus 时，通过调整 controller 或 kubelet 设置为空字符串。这是一个 alpha 字段，需要启用 RecoverVolumeExpansionFailure 功能。

5.1.6. .status.conditions

描述: 条件是持久性卷声明的当前条件。如果底层持久性卷被调整大小，则条件将设置为 'ResizeStarted'。
类型: array

5.1.7. .status.conditions[]

描述

PersistentVolumeClaimCondition contails 有关 pvc 状态的详细信息

类型

object

必填

type
status

属性	类型	描述
`lastProbeTime`	`Time`	lastProbeTime 是我们探测到条件的时间。
`lastTransitionTime`	`Time`	lastTransitionTime 是条件从一个状态转换到另一个状态的时间。
`message`	`string`	Message 是人类可读的消息，指示最后一次转换的详细信息。
`reason`	`string`	原因是唯一的，这应该是一个简短的机器理解字符串，给出了条件最后一次转换的原因。如果报告"ResizeStarted"，则表示已调整底层持久性卷的大小。
`status`	`字符串`
`type`	`字符串`

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

© 2024 Red Hat, Inc.