From d62f44ba6347db0913e5072d985e498cfb5deecd Mon Sep 17 00:00:00 2001 From: windsonsea Date: Wed, 4 Sep 2024 09:55:07 +0800 Subject: [PATCH] [zh] Sync resource-claim-template-v1alpha3.md --- ...md => resource-claim-template-v1alpha3.md} | 126 +++++++++--------- 1 file changed, 66 insertions(+), 60 deletions(-) rename content/zh-cn/docs/reference/kubernetes-api/workload-resources/{resource-claim-template-v1alpha2.md => resource-claim-template-v1alpha3.md} (86%) diff --git a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/resource-claim-template-v1alpha2.md b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/resource-claim-template-v1alpha3.md similarity index 86% rename from content/zh-cn/docs/reference/kubernetes-api/workload-resources/resource-claim-template-v1alpha2.md rename to content/zh-cn/docs/reference/kubernetes-api/workload-resources/resource-claim-template-v1alpha3.md index 6f58d1a048..8aa1a9eb12 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/resource-claim-template-v1alpha2.md +++ b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/resource-claim-template-v1alpha3.md @@ -1,39 +1,43 @@ --- api_metadata: - apiVersion: "resource.k8s.io/v1alpha2" - import: "k8s.io/api/resource/v1alpha2" + apiVersion: "resource.k8s.io/v1alpha3" + import: "k8s.io/api/resource/v1alpha3" kind: "ResourceClaimTemplate" content_type: "api_reference" description: "ResourceClaimTemplate 用于生成 ResourceClaim 对象。" -title: "ResourceClaimTemplate v1alpha2" -weight: 16 +title: "ResourceClaimTemplate v1alpha3" +weight: 17 --- -`apiVersion: resource.k8s.io/v1alpha2` +`apiVersion: resource.k8s.io/v1alpha3` -`import "k8s.io/api/resource/v1alpha2"` +`import "k8s.io/api/resource/v1alpha3"` ## ResourceClaimTemplate {#ResourceClaimTemplate} ResourceClaimTemplate 用于生成 ResourceClaim 对象。 +这是一个 Alpha 类型的特性，需要启用 DynamicResourceAllocation 特性门控。 +
-- **apiVersion**: resource.k8s.io/v1alpha2 +- **apiVersion**: resource.k8s.io/v1alpha3 - **kind**: ResourceClaimTemplate @@ -45,13 +49,13 @@ ResourceClaimTemplate 用于生成 ResourceClaim 对象。 标准的对象元数据。 -- **spec** (}}">ResourceClaimTemplateSpec), 必需 +- **spec** (}}">ResourceClaimTemplateSpec)，必需 描述要生成的 ResourceClaim。 @@ -67,20 +71,22 @@ ResourceClaimTemplateSpec 包含针对 ResourceClaim 的元数据和字段。
-*spec** (}}">ResourceClaimSpec), 必需 +- **spec** (}}">ResourceClaimSpec)，必需 ResourceClaim 的规约。整个内容将不加修改地复制到从模板创建的 ResourceClaim 中。 与 ResourceClaim 中相同的字段在此处也是有效的。 + +--> +- **metadata** (}}">ObjectMeta) + ObjectMeta 可以包含创建 PVC 时将要复制到其中的标签和注解。 不允许设置其他字段，并且即便设置了也会在验证期间被拒绝。 @@ -93,7 +99,7 @@ ResourceClaimTemplateList 是申领模板的集合。
-- **apiVersion**: resource.k8s.io/v1alpha2 +- **apiVersion**: resource.k8s.io/v1alpha3 - **kind**: ResourceClaimTemplateList @@ -105,11 +111,11 @@ ResourceClaimTemplateList 是申领模板的集合。 标准的列表元数据。 -- **items** ([]}}">ResourceClaimTemplate), 必需 +- **items** ([]}}">ResourceClaimTemplate)，必需 items 是资源申领模板的列表。 @@ -130,7 +136,7 @@ ResourceClaimTemplateList 是申领模板的集合。 #### HTTP 请求 -GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates/{name} +GET /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates/{name} #### 参数 -- **name** (**路径参数**): string, 必需 +- **name** (**路径参数**): string，必需 - name of the ResourceClaimTemplate + ResourceClaimTemplate 的名称。 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace @@ -166,7 +172,7 @@ GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates --> #### 响应 -200 (}}">ResourceClaimTemplate): OK +200 (}}">ResourceClaimTemplate): OK 401: Unauthorized @@ -179,7 +185,7 @@ GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates #### HTTP 请求 -GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates +GET /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates #### 参数 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace @@ -287,7 +293,7 @@ GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates --> #### 响应 -200 (}}">ResourceClaimTemplateList): OK +200 (}}">ResourceClaimTemplateList): OK 401: Unauthorized @@ -300,7 +306,7 @@ GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates #### HTTP 请求 -GET /apis/resource.k8s.io/v1alpha2/resourceclaimtemplates +GET /apis/resource.k8s.io/v1alpha3/resourceclaimtemplates #### 响应 -200 (}}">ResourceClaimTemplateList): OK +200 (}}">ResourceClaimTemplateList): OK 401: Unauthorized @@ -413,7 +419,7 @@ GET /apis/resource.k8s.io/v1alpha2/resourceclaimtemplates #### HTTP 请求 -POST /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates +POST /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates #### 参数 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace -- **body**: }}">ResourceClaimTemplate, 必需 +- **body**: }}">ResourceClaimTemplate，必需 - **dryRun** (**查询参数**): string @@ -469,11 +475,11 @@ POST /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplate --> #### 响应 -200 (}}">ResourceClaimTemplate): OK +200 (}}">ResourceClaimTemplate): OK -201 (}}">ResourceClaimTemplate): Created +201 (}}">ResourceClaimTemplate): Created -202 (}}">ResourceClaimTemplate): Accepted +202 (}}">ResourceClaimTemplate): Accepted 401: Unauthorized @@ -486,7 +492,7 @@ POST /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplate #### HTTP 请求 -PUT /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates/{name} +PUT /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates/{name} #### 参数 -- **name** (**路径参数**): string, 必需 +- **name** (**路径参数**): string，必需 - name of the ResourceClaimTemplate + ResourceClaimTemplate 的名称。 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace -- **body**: }}">ResourceClaimTemplate, 必需 +- **body**: }}">ResourceClaimTemplate，必需 - **dryRun** (**查询参数**): string @@ -550,9 +556,9 @@ PUT /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates --> #### 响应 -200 (}}">ResourceClaimTemplate): OK +200 (}}">ResourceClaimTemplate): OK -201 (}}">ResourceClaimTemplate): Created +201 (}}">ResourceClaimTemplate): Created 401: Unauthorized @@ -565,7 +571,7 @@ PUT /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates #### HTTP 请求 -PATCH /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates/{name} +PATCH /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates/{name} #### 参数 -- **name** (**路径参数**): string, 必需 +- **name** (**路径参数**): string，必需 - name of the ResourceClaimTemplate + ResourceClaimTemplate 的名称。 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace -- **body**: }}">Patch, 必需 +- **body**: }}">Patch，必需 - **dryRun** (**查询参数**): string @@ -637,9 +643,9 @@ PATCH /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplat --> #### 响应 -200 (}}">ResourceClaimTemplate): OK +200 (}}">ResourceClaimTemplate): OK -201 (}}">ResourceClaimTemplate): Created +201 (}}">ResourceClaimTemplate): Created 401: Unauthorized @@ -652,7 +658,7 @@ PATCH /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplat #### HTTP 请求 -DELETE /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates/{name} +DELETE /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates/{name} #### 参数 -- **name** (**路径参数**): string, 必需 +- **name** (**路径参数**): string，必需 - name of the ResourceClaimTemplate + ResourceClaimTemplate 的名称。 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace @@ -716,9 +722,9 @@ DELETE /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtempla --> #### 响应 -200 (}}">ResourceClaimTemplate): OK +200 (}}">ResourceClaimTemplate): OK -202 (}}">ResourceClaimTemplate): Accepted +202 (}}">ResourceClaimTemplate): Accepted 401: Unauthorized @@ -731,7 +737,7 @@ DELETE /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtempla #### HTTP 请求 -DELETE /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaimtemplates +DELETE /apis/resource.k8s.io/v1alpha3/namespaces/{namespace}/resourceclaimtemplates #### 参数 -- **namespace** (**路径参数**): string, 必需 +- **namespace** (**路径参数**): string，必需 }}">namespace