[zh-cn]sync custom-resource-definition-versioning.md

Signed-off-by: xin.li <[email protected]>

Author: my-git9

content/zh-cn/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definition-versioning.md

@@ -1070,6 +1070,49 @@ for a request to convert `CronTab` objects to `example.com/v1`:
 下面的示例显示了包含在 `ConversionReview` 对象中的数据，
 该请求意在将 `CronTab` 对象转换为 `example.com/v1`：
 
+<!--
+```yaml
+{
+  "apiVersion": "apiextensions.k8s.io/v1",
+  "kind": "ConversionReview",
+  "request": {
+    # Random uid uniquely identifying this conversion call
+    "uid": "705ab4f5-6393-11e8-b7cc-42010a800002",
+    
+    # The API group and version the objects should be converted to
+    "desiredAPIVersion": "example.com/v1",
+    
+    # The list of objects to convert.
+    # May contain one or more objects, in one or more versions.
+    "objects": [
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1beta1",
+        "metadata": {
+          "creationTimestamp": "2019-09-04T14:03:02Z",
+          "name": "local-crontab",
+          "namespace": "default",
+          "resourceVersion": "143",
+          "uid": "3415a7fc-162b-4300-b5da-fd6083580d66"
+        },
+        "hostPort": "localhost:1234"
+      },
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1beta1",
+        "metadata": {
+          "creationTimestamp": "2019-09-03T13:02:01Z",
+          "name": "remote-crontab",
+          "resourceVersion": "12893",
+          "uid": "359a83ec-b575-460d-b553-d859cedde8a0"
+        },
+        "hostPort": "example.com:2345"
+      }
+    ]
+  }
+}
+```
+-->
 {{< tabs name="ConversionReview_request" >}}
 {{% tab name="apiextensions.k8s.io/v1" %}}
 ```yaml
@@ -1113,6 +1156,50 @@ for a request to convert `CronTab` objects to `example.com/v1`:
 }
 ```
 {{% /tab %}}
+<!--
+```yaml
+{
+  # Deprecated in v1.16 in favor of apiextensions.k8s.io/v1
+  "apiVersion": "apiextensions.k8s.io/v1beta1",
+  "kind": "ConversionReview",
+  "request": {
+    # Random uid uniquely identifying this conversion call
+    "uid": "705ab4f5-6393-11e8-b7cc-42010a800002",
+    
+    # The API group and version the objects should be converted to
+    "desiredAPIVersion": "example.com/v1",
+    
+    # The list of objects to convert.
+    # May contain one or more objects, in one or more versions.
+    "objects": [
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1beta1",
+        "metadata": {
+          "creationTimestamp": "2019-09-04T14:03:02Z",
+          "name": "local-crontab",
+          "namespace": "default",
+          "resourceVersion": "143",
+          "uid": "3415a7fc-162b-4300-b5da-fd6083580d66"
+        },
+        "hostPort": "localhost:1234"
+      },
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1beta1",
+        "metadata": {
+          "creationTimestamp": "2019-09-03T13:02:01Z",
+          "name": "remote-crontab",
+          "resourceVersion": "12893",
+          "uid": "359a83ec-b575-460d-b553-d859cedde8a0"
+        },
+        "hostPort": "example.com:2345"
+      }
+    ]
+  }
+}
+```
+-->
 {{% tab name="apiextensions.k8s.io/v1beta1" %}}
 ```yaml
 {
@@ -1187,6 +1274,52 @@ Webhook 响应包含 200 HTTP 状态代码、`Content-Type: application/json`，
 
 Webhook 的最简单成功响应示例：
 
+<!--
+```yaml
+{
+  "apiVersion": "apiextensions.k8s.io/v1",
+  "kind": "ConversionReview",
+  "response": {
+    # must match <request.uid>
+    "uid": "705ab4f5-6393-11e8-b7cc-42010a800002",
+    "result": {
+      "status": "Success"
+    },
+    # Objects must match the order of request.objects, and have apiVersion set to <request.desiredAPIVersion>.
+    # kind, metadata.uid, metadata.name, and metadata.namespace fields must not be changed by the webhook.
+    # metadata.labels and metadata.annotations fields may be changed by the webhook.
+    # All other changes to metadata fields by the webhook are ignored.
+    "convertedObjects": [
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1",
+        "metadata": {
+          "creationTimestamp": "2019-09-04T14:03:02Z",
+          "name": "local-crontab",
+          "namespace": "default",
+          "resourceVersion": "143",
+          "uid": "3415a7fc-162b-4300-b5da-fd6083580d66"
+        },
+        "host": "localhost",
+        "port": "1234"
+      },
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1",
+        "metadata": {
+          "creationTimestamp": "2019-09-03T13:02:01Z",
+          "name": "remote-crontab",
+          "resourceVersion": "12893",
+          "uid": "359a83ec-b575-460d-b553-d859cedde8a0"
+        },
+        "host": "example.com",
+        "port": "2345"
+      }
+    ]
+  }
+}
+```
+-->
 {{< tabs name="ConversionReview_response_success" >}}
 {{% tab name="apiextensions.k8s.io/v1" %}}
 ```yaml
@@ -1234,6 +1367,53 @@ Webhook 的最简单成功响应示例：
 }
 ```
 {{% /tab %}}
+<!--
+```yaml
+{
+  # Deprecated in v1.16 in favor of apiextensions.k8s.io/v1
+  "apiVersion": "apiextensions.k8s.io/v1beta1",
+  "kind": "ConversionReview",
+  "response": {
+    # must match <request.uid>
+    "uid": "705ab4f5-6393-11e8-b7cc-42010a800002",
+    "result": {
+      "status": "Failed"
+    },
+    # Objects must match the order of request.objects, and have apiVersion set to <request.desiredAPIVersion>.
+    # kind, metadata.uid, metadata.name, and metadata.namespace fields must not be changed by the webhook.
+    # metadata.labels and metadata.annotations fields may be changed by the webhook.
+    # All other changes to metadata fields by the webhook are ignored.
+    "convertedObjects": [
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1",
+        "metadata": {
+          "creationTimestamp": "2019-09-04T14:03:02Z",
+          "name": "local-crontab",
+          "namespace": "default",
+          "resourceVersion": "143",
+          "uid": "3415a7fc-162b-4300-b5da-fd6083580d66"
+        },
+        "host": "localhost",
+        "port": "1234"
+      },
+      {
+        "kind": "CronTab",
+        "apiVersion": "example.com/v1",
+        "metadata": {
+          "creationTimestamp": "2019-09-03T13:02:01Z",
+          "name": "remote-crontab",
+          "resourceVersion": "12893",
+          "uid": "359a83ec-b575-460d-b553-d859cedde8a0"
+        },
+        "host": "example.com",
+        "port": "2345"
+      }
+    ]
+  }
+}
+```
+-->
 {{% tab name="apiextensions.k8s.io/v1beta1" %}}
 ```yaml
 {
@@ -1494,33 +1674,13 @@ The following is an example procedure to upgrade from `v1beta1` to `v1`.
 3. 从 CustomResourceDefinition 的 `status.storedVersions` 字段中删除 `v1beta1`。
 
 {{< note >}}
-<!--
-The flag `--subresource` is used with the kubectl get, patch, edit, and replace commands to
-fetch and update the subresources, `status` and `scale`, for all the API resources that
-support them. This flag is available starting from kubectl version v1.24. Previously, reading
-subresources (like `status`) via kubectl involved using `kubectl --raw`, and updating
-subresources using kubectl was not possible at all. Starting from v1.24, the `kubectl` tool
-can be used to edit or patch the `status` subresource on a CRD object. See [How to patch a Deployment using the subresource flag](/docs/tasks/manage-kubernetes-objects/update-api-object-kubectl-patch/#scale-kubectl-patch).
--->
-`--subresource` 标志在 kubectl get、patch、edit 和 replace 命令中用于获取和更新所有支持它们的
-API 资源的子资源、`status` 和 `scale`。此标志从 kubectl 版本 v1.24 开始可用。
-以前通过 kubectl 读取子资源（如 `status`）涉及使用 `kubectl --raw`，并且根本不可能使用 kubectl 更新子资源。
-从 v1.24 开始，`kubectl` 工具可用于编辑或修补有关 CRD 对象的 `status` 子资源。
-请参阅[如何使用子资源标志修补 Deployment](/zh-cn/docs/tasks/manage-kubernetes-objects/update-api-object-kubectl-patch/#scale-kubectl-patch)。
 
 <!--
-This page is part of the documentation for Kubernetes v{{< skew currentVersion >}}.
-If you are running a different version of Kubernetes, consult the documentation for that release.
-
 Here is an example of how to patch the `status` subresource for a CRD object using `kubectl`:
 -->
-此页面是 Kubernetes v{{< skew currentVersion >}} 文档的一部分。
-如果你运行的是不同版本的 Kubernetes，请查阅相应版本的文档。
-
 以下是如何使用 `kubectl` 为一个 CRD 对象修补 `status` 子资源的示例：
 
 ```bash
 kubectl patch customresourcedefinitions <CRD_Name> --subresource='status' --type='merge' -p '{"status":{"storedVersions":["v1"]}}'
 ```
 {{< /note >}}
-