Merge pull request #50530 from windsonsea/volment

[zh] storage-class-v1, volume-attachment-v1, volume-attributes-class-v1beta1
2025-04-20 07:16:59 -07:00 · 2025-04-20 07:16:59 -07:00 · 6fd3273b3e
parent 1e4f6e1849 b038f0c0b6
commit 6fd3273b3e
4 changed files with 79 additions and 24 deletions
--- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md
@ -248,7 +248,7 @@ GET /apis/storage.k8s.io/v1/storageclasses/{name}
 ### `list` list or watch objects of kind StorageClass
 #### HTTP Request
 -->
-### `list` 列出或观测类别为 StorageClass 的对象
+### `list` 列举或观测类别为 StorageClass 的对象

 #### HTTP 请求

@ -505,6 +505,7 @@ DELETE /apis/storage.k8s.io/v1/storageclasses/{name}
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 - **dryRun** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **pretty** (*in query*): string
 - **propagationPolicy** (*in query*): string
 -->
@ -524,6 +525,10 @@ DELETE /apis/storage.k8s.io/v1/storageclasses/{name}

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@ -560,6 +565,7 @@ DELETE /apis/storage.k8s.io/v1/storageclasses
 - **dryRun** (*in query*): string
 - **fieldSelector** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **labelSelector** (*in query*): string
 - **limit** (*in query*): integer
 - **pretty** (*in query*): string
@ -588,6 +594,10 @@ DELETE /apis/storage.k8s.io/v1/storageclasses

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
--- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-version-migration-v1alpha1.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-version-migration-v1alpha1.md
@ -29,7 +29,7 @@ auto_generated: true
 <!--
 StorageVersionMigration represents a migration of stored data to the latest storage version.
 -->
-StorageVersionMigration 表示将表示存储的数据向最新存储版本的一次迁移。
+StorageVersionMigration 表示存储的数据向最新存储版本的一次迁移。

 <hr>

@ -79,7 +79,7 @@ Spec of the storage version migration.

  The token used in the list options to get the next chunk of objects to migrate. When the .status.conditions indicates the migration is "Running", users can use this token to check the progress of the migration.

- **resource** (GroupVersionResource)，必需
+- **resource** (GroupVersionResource), required

  The resource that is being migrated. The migrator sends requests to the endpoint serving the resource. Immutable.

@ -88,7 +88,7 @@ Spec of the storage version migration.
 -->
 - **continueToken** (string)

-  在 list 操作中用来获取下一批要迁移的对象时要所用的令牌。
+  在 list 操作中用来获取下一批要迁移的对象时所用的令牌。
  当 `.status.conditions` 指示迁移处于 “Running” 状态时，用户可以使用此令牌检查迁移的进度。

 - **resource** (GroupVersionResource)，必需
@ -854,6 +854,10 @@ DELETE /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (*in query*): string

  <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@ -878,6 +882,10 @@ DELETE /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@ -929,6 +937,10 @@ DELETE /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (*in query*): string

  <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
@ -981,6 +993,10 @@ DELETE /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
--- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/volume-attachment-v1.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/volume-attachment-v1.md
@ -96,7 +96,7 @@ VolumeAttachmentSpec 是 VolumeAttachment 请求的规约。
  source represents the volume that should be attached.

  <a name="VolumeAttachmentSource"></a>
-  *VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.*
+  *VolumeAttachmentSource represents a volume that should be attached. Right now only PersistentVolumes can be attached via external attacher, in the future we may allow also inline volumes in pods. Exactly one member can be set.*

  - **source.inlineVolumeSpec** (<a href="{{< ref "../config-and-storage-resources/persistent-volume-v1#PersistentVolumeSpec" >}}">PersistentVolumeSpec</a>)
    inlineVolumeSpec contains all the information necessary to attach a persistent volume defined by a pod's inline VolumeSource. This field is populated only for the CSIMigration feature. It contains translated fields from a pod's inline VolumeSource to a PersistentVolumeSpec. This field is beta-level and is only honored by servers that enabled the CSIMigration feature.
@ -110,21 +110,22 @@ VolumeAttachmentSpec 是 VolumeAttachment 请求的规约。
  source 表示应挂接的卷。

  <a name="VolumeAttachmentSource"></a>
-  **VolumeAttachmentSource 表示应挂接的卷。现在只能通过外部挂接器挂接 PersistenVolume，
+  **VolumeAttachmentSource 表示应挂接的卷。现在只能通过外部挂接器挂接 PersistentVolume，
  将来我们可能还允许 Pod 中的内联卷。只能设置一个成员。**

  - **source.inlineVolumeSpec** (<a href="{{< ref "../config-and-storage-resources/persistent-volume-v1#PersistentVolumeSpec" >}}">PersistentVolumeSpec</a>)

    inlineVolumeSpec 包含挂接由 Pod 的内联 VolumeSource 定义的持久卷时所有必需的信息。
-    仅为 CSIMigation 功能填充此字段。
+    仅为 CSIMigation 特性填充此字段。
    它包含从 Pod 的内联 VolumeSource 转换为 PersistentVolumeSpec 的字段。
-    此字段处于 Beta 阶段，且只有启用 CSIMigration 功能的服务器才能使用此字段。
+    此字段处于 Beta 阶段，且只有启用 CSIMigration 特性的服务器才能使用此字段。

  - **source.persistentVolumeName** (string)

    persistentVolumeName 是要挂接的持久卷的名称。

 ## VolumeAttachmentStatus {#VolumeAttachmentStatus}
+
 <!--
 VolumeAttachmentStatus is the status of a VolumeAttachment request.

@ -149,7 +150,16 @@ VolumeAttachmentStatus 是 VolumeAttachment 请求的状态。

  <a name="VolumeError"></a>
  *VolumeError captures an error encountered during a volume operation.*
+-->
+- **attachError** (VolumeError)

+  attachError 表示挂接操作期间遇到的最后一个错误，如果有。
+  此字段只能由完成挂接操作的实体（例如外部挂接器）进行设置。
+
+  <a name="VolumeError"></a>
+  **VolumeError 抓取卷操作期间遇到的一个错误。**
+
+  <!--
  - **attachError.message** (string)

    message represents the error encountered during Attach or Detach operation. This string may be logged, so it should not contain sensitive information.
@ -160,14 +170,7 @@ VolumeAttachmentStatus 是 VolumeAttachment 请求的状态。

    <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.*
-->
- **attachError** (VolumeError)
-
-  attachError 表示挂接操作期间遇到的最后一个错误，如果有。
-  此字段只能由完成挂接操作的实体（例如外部挂接器）进行设置。
-
-  <a name="VolumeError"></a>
-  **VolumeError 抓取卷操作期间遇到的一个错误。**
+  -->

  - **attachError.message** (string)

@ -288,7 +291,7 @@ GET /apis/storage.k8s.io/v1/volumeattachments/{name}

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **pretty** (**查询参数**): string

@ -323,7 +326,7 @@ GET /apis/storage.k8s.io/v1/volumeattachments/{name}/status

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **pretty** (**查询参数**): string

@ -342,7 +345,7 @@ GET /apis/storage.k8s.io/v1/volumeattachments/{name}/status
 ### `list` list or watch objects of kind VolumeAttachment
 #### HTTP Request
 -->
-### `list` 列出或观测类别为 VolumeAttachment 的对象
+### `list` 列举或观测类别为 VolumeAttachment 的对象

 #### HTTP 请求

@ -491,7 +494,7 @@ PUT /apis/storage.k8s.io/v1/volumeattachments/{name}

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **body**: <a href="{{< ref "../config-and-storage-resources/volume-attachment-v1#VolumeAttachment" >}}">VolumeAttachment</a>，必需

@ -546,7 +549,7 @@ PUT /apis/storage.k8s.io/v1/volumeattachments/{name}/status

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **body**: <a href="{{< ref "../config-and-storage-resources/volume-attachment-v1#VolumeAttachment" >}}">VolumeAttachment</a>，必需

@ -602,7 +605,7 @@ PATCH /apis/storage.k8s.io/v1/volumeattachments/{name}

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>，必需

@ -662,7 +665,7 @@ PATCH /apis/storage.k8s.io/v1/volumeattachments/{name}/status

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>，必需

@ -714,6 +717,7 @@ DELETE /apis/storage.k8s.io/v1/volumeattachments/{name}
 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>
 - **dryRun** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **pretty** (*in query*): string
 - **propagationPolicy** (*in query*): string
 -->
@ -721,7 +725,7 @@ DELETE /apis/storage.k8s.io/v1/volumeattachments/{name}

 - **name** (**路径参数**): string，必需

-  VolumeAttachment 的名称
+  VolumeAttachment 的名称。

 - **body**: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions</a>

@ -733,6 +737,10 @@ DELETE /apis/storage.k8s.io/v1/volumeattachments/{name}

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@ -769,6 +777,7 @@ DELETE /apis/storage.k8s.io/v1/volumeattachments
 - **dryRun** (*in query*): string
 - **fieldSelector** (*in query*): string
 - **gracePeriodSeconds** (*in query*): integer
+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
 - **labelSelector** (*in query*): string
 - **limit** (*in query*): integer
 - **pretty** (*in query*): string
@ -797,6 +806,10 @@ DELETE /apis/storage.k8s.io/v1/volumeattachments

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
--- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/volume-attributes-class-v1beta1.md
+++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/volume-attributes-class-v1beta1.md
@ -511,6 +511,10 @@ DELETE /apis/storage.k8s.io/v1beta1/volumeattributesclasses/{name}

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (*in query*): string

  <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@ -535,6 +539,10 @@ DELETE /apis/storage.k8s.io/v1beta1/volumeattributesclasses/{name}

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **pretty** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
@ -586,6 +594,10 @@ DELETE /apis/storage.k8s.io/v1beta1/volumeattributesclasses

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (*in query*): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (*in query*): string

  <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>
@ -638,6 +650,10 @@ DELETE /apis/storage.k8s.io/v1beta1/volumeattributesclasses

  <a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds</a>

+- **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean
+
+  <a href="{{< ref "../common-parameters/common-parameters#ignoreStoreReadErrorWithClusterBreakingPotential" >}}">ignoreStoreReadErrorWithClusterBreakingPotential</a>
+
 - **labelSelector** (**查询参数**): string

  <a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector</a>