Merge pull request #50564 from my-git9/npa-15476

[zh-cn]sync binding-v1.md cron-job-v1.md
This commit is contained in:
Kubernetes Prow Robot 2025-04-20 20:51:00 -07:00 committed by GitHub
commit 33c75becb3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 47 additions and 92 deletions

View File

@ -28,10 +28,9 @@ auto_generated: true
## Binding {#Binding}
<!--
Binding ties one object to another; for example, a pod is bound to a node by a scheduler. Deprecated in 1.7, please use the bindings subresource of pods instead.
Binding ties one object to another; for example, a pod is bound to a node by a scheduler.
-->
Binding 将一个对象与另一个对象绑定在一起;例如,调度程序将一个 Pod 绑定到一个节点。
1.7 版中已弃用,请使用 Pod 的 Binding 子资源代替。
<hr>
@ -81,11 +80,11 @@ POST /api/v1/namespaces/{namespace}/bindings
-->
#### 参数
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
- **body**: <a href="{{< ref "../workload-resources/binding-v1#Binding" >}}">Binding</a>, 必需
- **body**: <a href="{{< ref "../workload-resources/binding-v1#Binding" >}}">Binding</a>必需
<!--
- **dryRun** (*in query*): string
@ -163,18 +162,18 @@ POST /api/v1/namespaces/{namespace}/pods/{name}/binding
-->
#### 参数
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
<!--
- **body**: <a href="{{< ref "../workload-resources/binding-v1#Binding" >}}">Binding</a>, required
-->
- **body**: <a href="{{< ref "../workload-resources/binding-v1#Binding" >}}">Binding</a>, 必需
- **body**: <a href="{{< ref "../workload-resources/binding-v1#Binding" >}}">Binding</a>必需
<!--
- **dryRun** (*in query*): string

View File

@ -4,7 +4,7 @@ api_metadata:
import: "k8s.io/api/batch/v1"
kind: "CronJob"
content_type: "api_reference"
description: "CronJob 代表单个定时作业 (Cron Job) 的配置。"
description: "CronJob 代表单个定时作业Cron Job的配置。"
title: "CronJob"
weight: 11
---
@ -29,7 +29,7 @@ auto_generated: true
<!--
CronJob represents the configuration of a single cron job.
-->
CronJob 代表单个定时作业Cron Job) 的配置。
CronJob 代表单个定时作业Cron Job的配置。
<hr>
@ -42,21 +42,24 @@ CronJob 代表单个定时作业Cron Job) 的配置。
<!--
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-->
标准的对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
标准的对象元数据。更多信息:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- **spec** (<a href="{{< ref "../workload-resources/cron-job-v1#CronJobSpec" >}}">CronJobSpec</a>)
<!--
Specification of the desired behavior of a cron job, including the schedule. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-->
定时作业的预期行为的规约包括排期表Schedule。更多信息 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
定时作业的预期行为的规约包括排期表Schedule。更多信息
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- **status** (<a href="{{< ref "../workload-resources/cron-job-v1#CronJobStatus" >}}">CronJobStatus</a>)
<!--
Current status of a cron job. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-->
定时作业的当前状态。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
定时作业的当前状态。更多信息:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
## CronJobSpec {#CronJobSpec}
@ -69,12 +72,12 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
<hr>
<!--
- **jobTemplate** (JobTemplateSpec), 必需
- **jobTemplate** (JobTemplateSpec), required
Specifies the job that will be created when executing a CronJob.
-->
- **jobTemplate** (JobTemplateSpec), 必需
- **jobTemplate** (JobTemplateSpec)必需
指定执行 CronJob 时将创建的作业。
@ -94,7 +97,8 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
- **jobTemplate.metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
从此模板创建的作业的标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
从此模板创建的作业的标准对象元数据。更多信息:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
<!--
- **jobTemplate.spec** (<a href="{{< ref "../workload-resources/job-v1#JobSpec" >}}">JobSpec</a>)
@ -104,7 +108,8 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
- **jobTemplate.spec** (<a href="{{< ref "../workload-resources/job-v1#JobSpec" >}}">JobSpec</a>)
对作业的预期行为的规约。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
对作业的预期行为的规约。更多信息:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
<!--
- **schedule** (string), required
@ -112,7 +117,7 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
The schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.
-->
- **schedule** (string), 必需
- **schedule** (string)必需
Cron 格式的排期表,请参阅 https://zh.wikipedia.org/wiki/Cron。
@ -130,7 +135,7 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
在执行期间由控制器管理器从系统范围的时区数据库进行加载。
如果找不到系统范围的时区数据库,则转而使用该数据库的捆绑版本。
如果时区名称在 CronJob 的生命周期内或由于主机配置更改而变得无效,该控制器将停止创建新的 Job
并将创建一个原因为 UnknownTimeZone 的系统事件。更多信息,请参阅
并将创建一个原因为 UnknownTimeZone 的系统事件。更多信息,请参阅
https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/cron-jobs/#time-zones。
<!--
@ -143,7 +148,7 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
- **concurrencyPolicy** (string)
指定如何处理作业的并发执行。 有效值为:
指定如何处理作业的并发执行。有效值为:
- "Allow" (默认):允许 CronJobs 并发运行;
- "Forbid":禁止并发运行,如果上一次运行尚未完成则跳过下一次运行;
@ -193,9 +198,6 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
<!--
CronJobStatus represents the current state of a cron job.
<hr>
-->
CronJobStatus 表示某个定时作业的当前状态。
@ -266,7 +268,8 @@ CronJobList 是定时作业的集合。
-->
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
标准列表元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
标准列表元数据。更多信息:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
<!--
- **items** ([]<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>), required
@ -315,11 +318,11 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
@ -332,11 +335,6 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
-->
#### 响应
<!--
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
401: Unauthorized
-->
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
401: Unauthorized
@ -373,11 +371,11 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
@ -387,12 +385,7 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
<!--
#### Response
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
401: Unauthorized
-->
#### 响应
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
@ -422,7 +415,7 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
@ -536,12 +529,7 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs
<!--
#### Response
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJobList" >}}">CronJobList</a>): OK
401: Unauthorized
-->
#### 响应
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJobList" >}}">CronJobList</a>): OK
@ -674,10 +662,6 @@ GET /apis/batch/v1/cronjobs
<!--
#### Response
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJobList" >}}">CronJobList</a>): OK
401: Unauthorized
-->
#### 响应
@ -707,14 +691,14 @@ POST /apis/batch/v1/namespaces/{namespace}/cronjobs
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
<!--
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>, required
-->
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>, 必需
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>必需
<!--
- **dryRun** (*in query*): string
@ -795,7 +779,7 @@ PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
name of the CronJob
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
@ -804,14 +788,14 @@ PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
<!--
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>, required
-->
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>, 必需
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>必需
<!--
- **dryRun** (*in query*): string
@ -888,7 +872,7 @@ PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
name of the CronJob
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
@ -897,14 +881,14 @@ PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
<!--
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>, required
-->
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>, 必需
- **body**: <a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>必需
<!--
- **dryRun** (*in query*): string
@ -944,12 +928,6 @@ PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
<!--
#### Response
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
201 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): Created
401: Unauthorized
-->
#### 响应
@ -981,7 +959,7 @@ PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
name of the CronJob
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
@ -990,14 +968,14 @@ PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
<!--
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, required
-->
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, 必需
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>必需
<!--
- **dryRun** (*in query*): string
@ -1046,12 +1024,6 @@ PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
<!--
#### Response
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
201 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): Created
401: Unauthorized
-->
#### 响应
@ -1083,7 +1055,7 @@ PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
name of the CronJob
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
@ -1092,14 +1064,14 @@ PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
<!--
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, required
-->
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, 必需
- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>必需
<!--
- **dryRun** (*in query*): string
@ -1149,12 +1121,6 @@ PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
<!--
#### Response
200 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): OK
201 (<a href="{{< ref "../workload-resources/cron-job-v1#CronJob" >}}">CronJob</a>): Created
401: Unauthorized
-->
#### 响应
@ -1186,7 +1152,7 @@ DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
name of the CronJob
-->
- **name** (**路径参数**): string, 必需
- **name** (**路径参数**): string必需
CronJob 的名称
@ -1195,7 +1161,7 @@ DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
@ -1251,12 +1217,6 @@ DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
<!--
#### Response
200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): OK
202 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): Accepted
401: Unauthorized
-->
#### 响应
@ -1288,7 +1248,7 @@ DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
-->
- **namespace** (**路径参数**): string, 必需
- **namespace** (**路径参数**): string必需
<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
@ -1416,10 +1376,6 @@ DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs
<!--
#### Response
200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status</a>): OK
401: Unauthorized
-->
#### 响应