Merge pull request #37204 from windsonsea/crdv1

[zh] sync /custom-resource-definition-v1.md

content/zh-cn/docs/reference/kubernetes-api/extend-resources/custom-resource-definition-v1.md

@@ -47,20 +47,20 @@ CustomResourceDefinition 表示应在 API 服务器上公开的资源。其名
   <!--
   spec describes how the user wants the resources to appear
   -->
-  spec 描述了用户希望资源的呈现方式
+  spec 描述了用户希望资源的呈现方式。
 
 - **status** (<a href="{{< ref "../extend-resources/custom-resource-definition-v1#CustomResourceDefinitionStatus" >}}">CustomResourceDefinitionStatus</a>)
   <!--
   status indicates the actual state of the CustomResourceDefinition
   -->
-  status 表示 CustomResourceDefinition 的实际状态
+  status 表示 CustomResourceDefinition 的实际状态。
 
 ## CustomResourceDefinitionSpec {#CustomResourceDefinitionSpec}
 
 <!--
 CustomResourceDefinitionSpec describes how a user wants their resource to appear
 -->
-CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
+CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式。
 
 <hr>
 
@@ -92,7 +92,7 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
 
     kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the `kind` attribute in API calls.
   -->
-  **CustomResourceDefinitionNames 表示提供此 CustomResourceDefinition 资源的名称**
+  **CustomResourceDefinitionNames 表示提供此 CustomResourceDefinition 资源的名称。**
 
   - **names.kind** (string)，必需
 
@@ -175,7 +175,7 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
 
     name is the version name, e.g. “v1”, “v2beta1”, etc. The custom resources are served under this version at `/apis/\<group>/\<version>/...` if `served` is true.
   -->
-  **CustomResourceDefinitionVersion 描述 CRD 的一个版本**
+  **CustomResourceDefinitionVersion 描述 CRD 的一个版本。**
 
   - **versions.name** (string)，必需
 
@@ -190,7 +190,7 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
 
   - **versions.served** (boolean)，必需
 
-    served 是用于启用/禁用该版本通过 REST API 提供服务的标志
+    served 是用于启用/禁用该版本通过 REST API 提供服务的标志。
 
   <!--
   - **versions.storage** (boolean), required
@@ -235,7 +235,7 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
 
     - **versions.additionalPrinterColumns.name** (string)，必需
 
-      name 是便于阅读的列名称
+      name 是便于阅读的列名称。
 
     <!--
     - **versions.additionalPrinterColumns.type** (string), required
@@ -254,7 +254,7 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
       description is a human readable description of this column.
       -->
 
-      description 是该列的可读性描述 
+      description 是该列的可读性描述。
 
     - **versions.additionalPrinterColumns.format** (string)
 
@@ -575,13 +575,13 @@ CustomResourceDefinitionSpec 描述了用户希望资源的呈现方式
 - **preserveUnknownFields** (boolean)
 
   <!--
-  preserveUnknownFields indicates that object fields which are not specified in the OpenAPI schema should be preserved when persisting to storage. apiVersion, kind, metadata and known fields inside metadata are always preserved. This field is deprecated in favor of setting `x-preserve-unknown-fields` to true in `spec.versions[*].schema.openAPIV3Schema`. See https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/#pruning-versus-preserving-unknown-fields for details.
+  preserveUnknownFields indicates that object fields which are not specified in the OpenAPI schema should be preserved when persisting to storage. apiVersion, kind, metadata and known fields inside metadata are always preserved. This field is deprecated in favor of setting `x-preserve-unknown-fields` to true in `spec.versions[*].schema.openAPIV3Schema`. See https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#field-pruning for details.
   -->
 
   preserveUnknownFields 表示将对象写入持久性存储时应保留 OpenAPI 模式中未规定的对象字段。
   apiVersion、kind、元数据（metadata）和元数据中的已知字段始终保留。不推荐使用此字段，而建议在
   `spec.versions[*].schema.openAPIV3Schema` 中设置 `x-preserve-unknown-fields` 为 true。
-  更多详细信息参见： https://kubernetes.io/zh-cn/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/#pruning-versus-preserving-unknown-fields
+  更多详细信息参见： https://kubernetes.io/zh-cn/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#field-pruning
 
 ## JSONSchemaProps {#JSONSchemaProps}
 
@@ -997,7 +997,7 @@ JSONSchemaProps 是JSON 模式（JSON-Schema），遵循其规范草案第 4 版
 <!--
 CustomResourceDefinitionStatus indicates the state of the CustomResourceDefinition
 -->
-CustomResourceDefinitionStatus 表示 CustomResourceDefinition 的状态
+CustomResourceDefinitionStatus 表示 CustomResourceDefinition 的状态。
 
 <hr>
 
@@ -1018,7 +1018,7 @@ CustomResourceDefinitionStatus 表示 CustomResourceDefinition 的状态
     kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the `kind` attribute in API calls.
   -->
 
-  **CustomResourceDefinitionNames 表示提供此 CustomResourceDefinition 资源的名称**
+  **CustomResourceDefinitionNames 表示提供此 CustomResourceDefinition 资源的名称。**
 
   - **acceptedNames.kind** (string)，必需