[zh-cn]sync namespace-v1

my-git9 · my-git9 · commit 51287cacefb4 · 2025-11-18T19:23:55.000+08:00
Signed-off-by: xin.li &lt;xin.li@daocloud.io&gt;
diff --git a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/namespace-v1.md b/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/namespace-v1.md
@@ -43,21 +43,27 @@ Namespace 为名字提供作用域。使用多个命名空间是可选的。
   <!--
   Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
   -->
-  标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+  
+  标准的对象元数据。更多信息：
+  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../cluster-resources/namespace-v1#NamespaceSpec" >}}">NamespaceSpec</a>)
 
   <!--
   Spec defines the behavior of the Namespace. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
   -->
-  spec 定义了 Namespace 的行为。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+  
+  `spec` 定义了 Namespace 的行为。更多信息：
+  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
 
 - **status** (<a href="{{< ref "../cluster-resources/namespace-v1#NamespaceStatus" >}}">NamespaceStatus</a>)
 
   <!--
   Status describes the current status of a Namespace. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
   -->
-  status 描述了当前 Namespace 的状态。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
+  
+  `status` 描述了当前 Namespace 的状态。更多信息：
+  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
 
 ## NamespaceSpec {#NamespaceSpec}
 
@@ -74,7 +80,8 @@ NamespaceSpec 用于描述 Namespace 的属性。
   Finalizers is an opaque list of values that must be empty to permanently remove object from storage. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
   -->
 
-  finalizers 是一个不透明的值列表，只有此列表为空时才能从存储中永久删除对象。 更多信息： https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/
+  `finalizers` 是一个不透明的值列表，只有此列表为空时才能从存储中永久删除对象。
+  更多信息： https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/
 
   <!--
   *Atomic: will be replaced during a merge*
@@ -100,6 +107,7 @@ NamespaceStatus 表示 Namespace 的当前状态信息。
   
   Represents the latest available observations of a namespace's current state.
   -->
+  
   **补丁策略：基于 `type` 健合并**
 
   **Map：键 `type` 的唯一值将在合并期间保留**
@@ -114,11 +122,13 @@ NamespaceStatus 表示 Namespace 的当前状态信息。
 
     Status of the condition, one of True, False, Unknown.
   -->
+  
   **NamespaceCondition 包含命名空间状态的详细信息。**
 
   - **conditions.status** (string)，必需
 
-    状况（condition）的状态，取值为 True、False 或 Unknown 之一。
+    状况（condition）的状态，取值为 `True`、`False` 或 `Unknown` 之一。
+
   <!--
   - **conditions.type** (string), required
 
@@ -128,6 +138,7 @@ NamespaceStatus 表示 Namespace 的当前状态信息。
   
     Last time the condition transitioned from one status to another.
   -->
+  
   - **conditions.type** (string), 必需
 
     命名空间控制器状况的类型。
@@ -140,30 +151,42 @@ NamespaceStatus 表示 Namespace 的当前状态信息。
     <!--
     *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.*
     -->
-    **Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。为 time 包的许多函数方法提供了封装器。**
+    
+    **`Time` 是对 `time.Time` 的封装。`Time` 支持对 YAML 和 JSON 进行正确封包。
+    为 `time` 包的许多函数方法提供了封装器。**
 
   - **conditions.message** (string)
 
     <!--
     Human-readable message indicating details about last transition.
     -->
-  
+
     人类可读的消息，指示上次转换的详细信息。
 
   - **conditions.reason** (string)
 
     <!--
     Unique, one-word, CamelCase reason for the condition's last transition.
     -->
-  
+
     唯一、一个单词、驼峰命名的 Condition 转换原因。
 
 - **phase** (string)
 
   <!--
   Phase is the current lifecycle phase of the namespace. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
+
+  Possible enum values:
+   - `"Active"` means the namespace is available for use in the system
+   - `"Terminating"` means the namespace is undergoing graceful termination
   -->
-  phase 是命名空间的当前生命周期阶段。更多信息： https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/
+  
+  `phase` 是命名空间的当前生命周期阶段。更多信息：
+  https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/
+
+  可能的枚举值：
+   - `"Active"` 表示命名空间在系统中可用
+   - `"Terminating"` 表示命名空间正在被体面终止
 
 ## NamespaceList {#NamespaceList}
 
@@ -179,10 +202,13 @@ NamespaceList 是一个命名空间列表。
 - **kind**: NamespaceList
 
 - **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
+ 
   <!--
   Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
   -->
-  标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+  
+  标准的列表元数据。更多信息：
+  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
 
 <!--
 - **items** ([]<a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>), required
@@ -193,7 +219,9 @@ NamespaceList 是一个命名空间列表。
   <!--
   Items is the list of Namespace objects in the list. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
   -->
-  items 是列表中的 Namespace 对象列表。更多信息： https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/namespaces/
+  
+  `items` 是列表中的 Namespace 对象列表。更多信息：
+  https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/namespaces/
 
 <!--
 ## Operations {#Operations}
@@ -228,7 +256,7 @@ GET /api/v1/namespaces/{name}
 -->
 - **name** (**路径参数**)：string，必需
 
-  Namespace 的名称
+  Namespace 的名称。
 
 - **pretty** (**查询参数**)：string
 
@@ -267,7 +295,7 @@ GET /api/v1/namespaces/{name}/status
 -->
 - **name** (**路径参数**)：string，必需
 
-  Namespace 的名称
+  Namespace 的名称。
 <!--
 - **pretty** (*in query*): string
 -->
@@ -361,7 +389,7 @@ GET /api/v1/namespaces
 <!--
 - **sendInitialEvents** (*in query*): boolean
 -->
-- **resourceVersionMatch** (**查询参数**): string
+- **resourceVersionMatch** (**查询参数**)：string
 
   <a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
 
@@ -617,7 +645,7 @@ PUT /api/v1/namespaces/{name}/status
 
   Namespace 的名称
 
-- **body**: <a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>，必需  
+- **body**: <a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>，必需
 
 <!--
 - **dryRun** (*in query*): string
diff --git 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
@@ -61,11 +61,11 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 
 - **provisioner** (string)，必需
 
-  provisioner 表示制备器的类别。
+  `provisioner` 表示制备器的类别。
 
 - **allowVolumeExpansion** (boolean)
 
-  allowVolumeExpansion 显示存储类是否允许卷扩充。
+  `allowVolumeExpansion` 显示存储类是否允许卷扩充。
 
 <!--
 - **allowedTopologies** ([]TopologySelectorTerm)
@@ -81,20 +81,20 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 
   **原子性：将在合并期间被替换**
   
-  allowedTopologies 限制可以动态制备卷的节点拓扑。每个卷插件定义其自己支持的拓扑规约。
+  `allowedTopologies` 限制可以动态制备卷的节点拓扑。每个卷插件定义其自己支持的拓扑规约。
   空的 TopologySelectorTerm 列表意味着没有拓扑限制。
   只有启用 VolumeScheduling 功能特性的服务器才能使用此字段。
   
   <a name="TopologySelectorTerm"></a>
   **拓扑选择器条件表示标签查询的结果。
-  一个 null 或空的拓扑选择器条件不会匹配任何对象。各个条件的要求按逻辑与的关系来计算。
-  此选择器作为 NodeSelectorTerm 所提供功能的子集。这是一个 Alpha 特性，将来可能会变更。**
+  一个 `null` 或空的拓扑选择器条件不会匹配任何对象。各个条件的要求按逻辑与的关系来计算。
+  此选择器作为 `NodeSelectorTerm` 所提供功能的子集。这是一个 Alpha 特性，将来可能会变更。**
 
   <!--
   - **allowedTopologies.matchLabelExpressions** ([]TopologySelectorLabelRequirement)
 
     *Atomic: will be replaced during a merge*
-    
+
     A list of topology selector requirements by labels.
 
     <a name="TopologySelectorLabelRequirement"></a>
@@ -136,7 +136,7 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 - **mountOptions** ([]string)
 
   *Atomic: will be replaced during a merge*
-  
+
   mountOptions controls the mountOptions for dynamically provisioned PersistentVolumes of this storage class. e.g. ["ro", "soft"]. Not validated - mount of the PVs will simply fail if one is invalid.
 
 - **parameters** (map[string]string)
@@ -152,27 +152,47 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存
 
 - **parameters** (map[string]string)
 
-  parameters 包含应创建此存储类卷的制备器的参数。
+  `parameters` 包含应创建此存储类卷的制备器的参数。
 
 <!--
 - **reclaimPolicy** (string)
 
   reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete.
 
-- **volumeBindingMode** (string)
-
-  volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+  Possible enum values:
+   - `"Delete"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.
+   - `"Recycle"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.
+   - `"Retain"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.
 -->
 - **reclaimPolicy** (string)
 
-  reclaimPolicy 控制此存储类动态制备的 PersistentVolume 的 reclaimPolicy。默认为 Delete。
+  `reclaimPolicy` 控制此存储类动态制备的 PersistentVolume 的 `reclaimPolicy`。默认为 Delete。
+
+  可能的枚举值：
+  - `"Delete"` 表示当卷被从其申领中释放时，将被从 Kubernetes 中删除。卷插件必须支持删除。
+  - `"Recycle"` 表示当卷被从其申领中释放时，将被回收回到未绑定的持久卷池中。卷插件必须支持回收。
+  - `"Retain"` 表示卷将在其当前阶段（已释放）中保留，以供管理员手动回收。默认策略是 `"Retain"`。
+  
+<!--
+- **volumeBindingMode** (string)
 
+  volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound.  When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature.
+
+  Possible enum values:
+   - `"Immediate"` indicates that PersistentVolumeClaims should be immediately provisioned and bound. This is the default mode.
+   - `"WaitForFirstConsumer"` indicates that PersistentVolumeClaims should not be provisioned and bound until the first Pod is created that references the PeristentVolumeClaim. The volume provisioning and binding will occur during Pod scheduing.
+-->
 - **volumeBindingMode** (string)
 
-  volumeBindingMode 指示应该如何制备和绑定 PersistentVolumeClaim。
+  `volumeBindingMode` 指示应该如何制备和绑定 PersistentVolumeClaim。
   未设置时，将使用 VolumeBindingImmediate。
   只有启用 VolumeScheduling 功能特性的服务器才能使用此字段。
 
+  可能的枚举值：
+  - `"Immediate"` 表示应立即制备并绑定持久卷申领。这是默认模式。
+  - `"WaitForFirstConsumer"` 表示直到引用了持久卷申领的第一个 Pod 被创建之前，
+    不应制备或绑定持久卷申领。卷的制备和绑定将在 Pod 调度期间发生。
+
 ## StorageClassList {#StorageClassList}
 
 <!--
@@ -202,7 +222,7 @@ StorageClassList 是存储类的集合。
 
 - **items** ([]<a href="{{< ref "../config-and-storage-resources/storage-class-v1#StorageClass" >}}">StorageClass</a>)，必需
 
-  items 是 StorageClass 的列表。
+  `items` 是 StorageClass 的列表。
 
 <!--
 ## Operations {#Operations}
