diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1.md index 557df8a0ee..1ba38a01b7 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1.md @@ -119,6 +119,7 @@ PersistentVolumeClaimSpec 描述存储设备的常用参数,并支持通过 so This field is immutable. It can only be set for containers. --> + **集合:键 name 的唯一值将在合并期间被保留** claims 列出了此容器使用的、在 spec.resourceClaims 中定义的资源的名称。 @@ -240,7 +241,6 @@ dataSourceRef specifies the object from which to populate the volume with data, (Alpha) 使用 dataSourceRef 的名字空间字段需要启用 CrossNamespaceVolumeDataSource 特性门控。 - ** +- **allocatedResourceStatuses** (map[string]string) + + allocatedResourceStatuses 存储为给定 PVC 而调整大小的资源的状态。键名遵循标准的 Kubernetes 标签语法。 + 有效值为: + * 未加前缀的键: + - storage - 卷的容量。 + * 自定义资源必须使用实现定义的带前缀的名称,如 "example.com/my-custom-resource"。 + 除上述值之外,未加前缀或具有 `kubernetes.io` 前缀的键被视为保留键,因此不能使用。 + + + ClaimResourceStatus 可以处于以下任一状态: + - ControllerResizeInProgress:大小调整控制器开始在控制平面中调整卷大小时所设置的状态。 + - ControllerResizeFailed:大小调整控制器出现致命错误导致大小调整失败时所设置的状态。 + - NodeResizePending:大小调整控制器已完成对卷大小的调整但需要在节点上进一步调整卷大小时的状态。 + - NodeResizeInProgress:kubelet 开始调整卷大小时所设置的状态。 + - NodeResizeFailed:kubelet 在出现致命错误而导致大小调整失败时所设置的状态。 + 临时错误不会设置 NodeResizeFailed。 + + + 例如:如果扩展 PVC 以获取更多的容量,则此字段可以是以下状态之一: + - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress" + - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed" + - pvc.status.allocatedResourceStatus['storage'] = "NodeResizePending" + - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress" + - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed" + 当未设置此字段时,表示没有针对给定 PVC 执行大小调整操作。 + + + 如果控制器收到具有先前未知的 resourceName 或 ClaimResourceStatus 的 PVC 更新, + 则该控制器应忽略此项更新才能按预期工作。例如,仅负责调整卷容量大小的控制器应忽略更改与 + PVC 关联的其他合法资源的 PVC 更新。 + + 这是一个 Alpha 字段,需要启用 RecoverVolumeExpansionFailure 功能特性。 + - **allocatedResources** (map[string]}}">Quantity) - allocatedResources 跟踪分配给 PVC 的容量。 + + allocatedResources 跟踪分配给 PVC 的资源,包括其容量。键名遵循标准的 Kubernetes 标签语法。 + 有效值为: + * 未加前缀的键: + - storage - 卷的容量。 + * 自定义资源必须使用实现定义的带前缀的名称,如 "example.com/my-custom-resource"。 + 除上述值之外,未加前缀或具有 `kubernetes.io` 前缀的键被视为保留键,因此不能使用。 + + 当出现卷扩充操作请求时,此字段可能大于实际的容量。 就存储配额而言,将使用 allocatedResources 和 PVC.spec.resources 二者中的更大值。 如果未设置 allocatedResources,则 PVC.spec.resources 单独用于配额计算。 如果减小一个卷扩充容量请求,则仅当没有正在进行的扩充操作且实际卷容量等于或小于请求的容量时, 才会减小 allocatedResources。 + + + 如果控制器收到具有先前未知的 resourceName 的 PVC 更新,则该控制器应忽略此项更新才能按预期工作。 + 例如,仅负责调整卷容量大小的控制器应忽略更改与 PVC 关联的其他合法资源的 PVC 更新。 + 这是一个 Alpha 字段,需要启用 RecoverVolumeExpansionFailure 功能特性。 - **phase** (string) phase 表示 PersistentVolumeClaim 的当前阶段。 -- **resizeStatus** (string) - - resizeStatus 存储大小调整操作的状态。默认不设置 resizeStatus,但在扩充完成时, - resizeStatus 将由大小调整控制器或 kubelet 设为空。 - 这是一个 Alpha 字段,需要启用 RecoverVolumeExpansionFailure 功能特性。 - ## PersistentVolumeClaimList {#PersistentVolumeClaimList}