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