--- api_metadata: apiVersion: "v1" import: "k8s.io/api/core/v1" kind: "PodTemplate" content_type: "api_reference" description: "PodTemplate 描述一种模板，用来为预定义的 Pod 生成副本。" title: "PodTemplate" weight: 3 --- `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 - **sendInitialEvents**（**查询参数**）: boolean }}">sendInitialEvents - **shardSelector**（**查询参数**）: string }}">shardSelector - **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 - **sendInitialEvents**（**查询参数**）: boolean }}">sendInitialEvents - **shardSelector**（**查询参数**）: string }}">shardSelector - **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 - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **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 - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **labelSelector**（**查询参数**）：string }}">labelSelector - **limit**（**查询参数**）：integer }}">limit - **pretty**（**查询参数**）：string }}">pretty - **propagationPolicy**（**查询参数**）：string }}">propagationPolicy - **resourceVersion**（**查询参数**）：string }}">resourceVersion - **resourceVersionMatch**（**查询参数**）：string }}">resourceVersionMatch - **sendInitialEvents**（**查询参数**）: boolean }}">sendInitialEvents - **shardSelector**（**查询参数**）: string }}">shardSelector - **timeoutSeconds**（**查询参数**）：integer }}">timeoutSeconds #### 响应 200 (}}">Status): OK 401: Unauthorized