diff --git a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-template-v1.md b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-template-v1.md new file mode 100644 index 0000000000..8cf52bffe6 --- /dev/null +++ b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-template-v1.md @@ -0,0 +1,779 @@ +--- +api_metadata: + apiVersion: "v1" + import: "k8s.io/api/core/v1" + kind: "PodTemplate" +content_type: "api_reference" +description: "PodTemplate 描述一种模板,用来为预定义的 Pod 生成副本。" +title: "PodTemplate" +weight: 2 +--- + + + +`apiVersion: v1` + +`import "k8s.io/api/core/v1"` + +## PodTemplate {#PodTemplate} + + +PodTemplate 描述一种模板,用来为预定义的 Pod 生成副本。 + +
+ +- **apiVersion**: v1 + +- **kind**: PodTemplate + +- **metadata** (}}">ObjectMeta) + + + 标准的对象元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + +- **template** (}}">PodTemplateSpec) + + + template 定义将基于此 Pod 模板所创建的 Pod。 + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + +## PodTemplateSpec {#PodTemplateSpec} + + +PodTemplateSpec 描述基于某模板所创建的 Pod 所应具有的数据。 + +
+ +- **metadata** (}}">ObjectMeta) + + + 标准的对象元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + +- **spec** (}}">PodSpec) + + + Pod 预期行为的规约。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + +## PodTemplateList {#PodTemplateList} + + +PodTemplateList 是 PodTemplate 对象的列表。 + +
+ +- **apiVersion**: v1 + +- **kind**: PodTemplateList + +- **metadata** (}}">ListMeta) + + + 标准的列表元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + + +- **items** ([]}}">PodTemplate),必需 + + + PodTemplate 对象列表。 + + +## 操作 {#Operations} + +
+ + +### `get` 读取指定的 PodTemplate + +#### HTTP 请求 + +GET /api/v1/namespaces/{namespace}/podtemplates/{name} + + +#### 参数 + + +- **name** (**路径参数**):string,必需 + + PodTemplate 的名称 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + + +- **pretty** (**查询参数**):string + + }}">pretty + + +#### 响应 + +200 (}}">PodTemplate): OK + +401: Unauthorized + + +### `list` 列出或监视 PodTemplate 类型的对象 + +#### HTTP 请求 + +GET /api/v1/namespaces/{namespace}/podtemplates + + +#### 参数 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + + +- **allowWatchBookmarks** (**查询参数**):boolean + + }}">allowWatchBookmarks + + +- **continue** (**查询参数**):string + + }}">continue + + +- **fieldSelector** (**查询参数**):string + + }}">fieldSelector + + +- **labelSelector** (**查询参数**):string + + }}">labelSelector + + +- **limit** (**查询参数**):integer + + }}">limit + + +- **pretty** (**查询参数**):string + + }}">pretty + + +- **resourceVersion** (**查询参数**):string + + }}">resourceVersion + + +- **resourceVersion** (**查询参数**):string + + }}">resourceVersionMatch + + +- **timeoutSeconds** (**查询参数**):integer + + }}">timeoutSeconds + + +- **watch** (**查询参数**):boolean + + }}">watch + + +#### 响应 + +200 (}}">PodTemplateList): OK + +401: Unauthorized + + +### `list` 列出或监视 PodTemplate 类型的对象 + +#### HTTP 请求 + +GET /api/v1/podtemplates + + +#### 参数 + + +- **allowWatchBookmarks** (**查询参数**):boolean + + }}">allowWatchBookmarks + + +- **continue** (**查询参数**):string + + }}">continue + + +- **fieldSelector** (**查询参数**):string + + }}">fieldSelector + + +- **labelSelector** (**查询参数**):string + + }}">labelSelector + + +- **limit** (**查询参数**):integer + + }}">limit + + +- **pretty** (**查询参数**):string + + }}">pretty + + +- **resourceVersion** (**查询参数**):string + + }}">resourceVersion + + +- **resourceVersionMatch** (**查询参数**):string + + }}">resourceVersionMatch + + +- **timeoutSeconds** (**查询参数**):integer + + }}">timeoutSeconds + + +- **watch** (**查询参数**):boolean + + }}">watch + + +#### 响应 + +200 (}}">PodTemplateList): OK + +401: Unauthorized + + +### `create` 创建一个 PodTemplate + +#### HTTP 请求 + +POST /api/v1/namespaces/{namespace}/podtemplates + + +#### 参数 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + + +- **body**: }}">PodTemplate,必需 + + +- **dryRun** (**查询参数**):string + + }}">dryRun + + +- **fieldManager** (**查询参数**):string + + }}">fieldManager + + +- **fieldValidation** (**查询参数**):string + + }}">fieldValidation + + +- **pretty** (**查询参数**):string + + }}">pretty + + +#### 响应 + +200 (}}">PodTemplate): OK + +201 (}}">PodTemplate): Created + +202 (}}">PodTemplate): Accepted + +401: Unauthorized + + +### `update` 替换指定的 PodTemplate + +#### HTTP 请求 + +PUT /api/v1/namespaces/{namespace}/podtemplates/{name} + + +#### 参数 + + +- **name** (**路径参数**):string,必需 + + PodTemplate 的名称 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + + +- **body**: }}">PodTemplate,必需 + + +- **dryRun** (**查询参数**):string + + }}">dryRun + + +- **fieldManager** (**查询参数**):string + + }}">fieldManager + + +- **fieldValidation** (**查询参数**):string + + }}">fieldValidation + + +- **pretty** (**查询参数**):string + + }}">pretty + + +#### 响应 + +200 (}}">PodTemplate): OK + +201 (}}">PodTemplate): Created + +401: Unauthorized + + +### `patch` 部分更新指定的 PodTemplate + +#### HTTP 请求 + +PATCH /api/v1/namespaces/{namespace}/podtemplates/{name} + + +#### 参数 + + +- **name** (**路径参数**):string,必需 + + PodTemplate 的名称 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + + +- **body**: }}">Patch,必需 + + +- **dryRun** (**查询参数**):string + + }}">dryRun + + +- **fieldManager** (**查询参数**):string + + }}">fieldManager + + +- **fieldValidation** (**查询参数**):string + + }}">fieldValidation + + +- **force** (**查询参数**):boolean + + }}">force + + +- **pretty** (**查询参数**):string + + }}">pretty + + +#### 响应 + +200 (}}">PodTemplate): OK + +201 (}}">PodTemplate): Created + +401: Unauthorized + + +### `delete` 删除一个 PodTemplate + +#### HTTP 请求 + +DELETE /api/v1/namespaces/{namespace}/podtemplates/{name} + + +#### 参数 + + +- **name** (**路径参数**):string,必需 + + PodTemplate 的名称 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + + +- **body**: }}">DeleteOptions + + +- **dryRun** (**查询参数**):string + + }}">dryRun + + +- **gracePeriodSeconds** (**查询参数**):integer + + }}">gracePeriodSeconds + + +- **pretty** (**查询参数**):string + + }}">pretty + + +- **propagationPolicy** (**查询参数**):string + + }}">propagationPolicy + + +#### 响应 + +200 (}}">PodTemplate): OK + +202 (}}">PodTemplate): Accepted + +401: Unauthorized + + +### `deletecollection` 删除 PodTemplate 的集合 + +#### HTTP 请求 + +DELETE /api/v1/namespaces/{namespace}/podtemplates + + +#### 参数 + + +- **namespace** (**路径参数**):string,必需 + + }}">namespace + +- **body**: }}">DeleteOptions + + +- **continue** (**查询参数**):string + + }}">continue + + +- **dryRun** (**查询参数**):string + + }}">dryRun + + +- **fieldSelector** (**查询参数**):string + + }}">fieldSelector + + +- **gracePeriodSeconds** (**查询参数**):integer + + }}">gracePeriodSeconds + + +- **labelSelector** (**查询参数**):string + + }}">labelSelector + + +- **limit** (**查询参数**):integer + + }}">limit + + +- **pretty** (**查询参数**):string + + }}">pretty + + +- **propagationPolicy** (**查询参数**):string + + }}">propagationPolicy + + +- **resourceVersion** (**查询参数**):string + + }}">resourceVersion + + +- **resourceVersionMatch** (**查询参数**):string + + }}">resourceVersionMatch + + +- **timeoutSeconds** (**查询参数**):integer + + }}">timeoutSeconds + + +#### 响应 + +200 (}}">Status): OK + +401: Unauthorized +