Skip to content

Commit 2dbd634

Browse files
k8s-ci-robotk8s-ci-robot
authored
Merge pull request #41115 from my-git9/path-26000
[zh-cn] sync some docs for kubernetes-api
2 parents 0c835d8 + c1f92e7 commit 2dbd634

File tree

6 files changed

+114
-9
lines changed

6 files changed

+114
-9
lines changed

‎content/zh-cn/docs/reference/kubernetes-api/authorization-resources/cluster-role-v1.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -261,6 +261,10 @@ GET /apis/rbac.authorization.k8s.io/v1/clusterroles
261261

262262
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
263263

264+
- **sendInitialEvents** (**查询参数**): boolean
265+
266+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
267+
264268
- **timeoutSeconds**（**查询参数**）：integer
265269

266270
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -568,6 +572,10 @@ DELETE /apis/rbac.authorization.k8s.io/v1/clusterroles
568572

569573
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
570574

575+
- **sendInitialEvents** (**查询参数**): boolean
576+
577+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
578+
571579
- **timeoutSeconds**（**查询参数**）：integer
572580

573581
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>

‎content/zh-cn/docs/reference/kubernetes-api/authorization-resources/role-binding-v1.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -230,6 +230,8 @@ GET /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/rolebindings
230230
<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion</a>
231231
- **resourceVersionMatch** (*in query*): string
232232
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
233+
- **sendInitialEvents** (*in query*): boolean
234+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
233235
- **timeoutSeconds** (*in query*): integer
234236
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
235237
- **watch** (*in query*): boolean
@@ -273,6 +275,10 @@ GET /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/rolebindings
273275

274276
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
275277

278+
- **sendInitialEvents** (**查询参数**): boolean
279+
280+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
281+
276282
- **timeoutSeconds** (**查询参数**): integer
277283

278284
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -316,6 +322,8 @@ GET /apis/rbac.authorization.k8s.io/v1/rolebindings
316322
<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion</a>
317323
- **resourceVersionMatch** (*in query*): string
318324
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
325+
- **sendInitialEvents** (*in query*): boolean
326+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
319327
- **timeoutSeconds** (*in query*): integer
320328
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
321329
- **watch** (*in query*): boolean
@@ -355,6 +363,10 @@ GET /apis/rbac.authorization.k8s.io/v1/rolebindings
355363

356364
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
357365

366+
- **sendInitialEvents** (**查询参数**): boolean
367+
368+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
369+
358370
- **timeoutSeconds** (**查询参数**): integer
359371

360372
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -654,6 +666,8 @@ DELETE /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/rolebindings
654666
<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion</a>
655667
- **resourceVersionMatch** (*in query*): string
656668
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
669+
- **sendInitialEvents** (*in query*): boolean
670+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
657671
- **timeoutSeconds** (*in query*): integer
658672
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
659673
-->
@@ -705,6 +719,10 @@ DELETE /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/rolebindings
705719

706720
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
707721

722+
- **sendInitialEvents** (**查询参数**): boolean
723+
724+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
725+
708726
- **timeoutSeconds** (**查询参数**): integer
709727

710728
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>

‎content/zh-cn/docs/reference/kubernetes-api/authorization-resources/role-v1.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,8 @@ GET /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles
212212
<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion</a>
213213
- **resourceVersionMatch** (*in query*): string
214214
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
215+
- **sendInitialEvents** (*in query*): boolean
216+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
215217
- **timeoutSeconds** (*in query*): integer
216218
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
217219
- **watch** (*in query*): boolean
@@ -255,6 +257,10 @@ GET /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles
255257

256258
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
257259

260+
- **sendInitialEvents** (**查询参数**): boolean
261+
262+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
263+
258264
- **timeoutSeconds**（**查询参数**）：integer
259265

260266
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -300,6 +306,8 @@ GET /apis/rbac.authorization.k8s.io/v1/roles
300306
<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion</a>
301307
- **resourceVersionMatch** (*in query*): string
302308
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
309+
- **sendInitialEvents** (*in query*): boolean
310+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
303311
- **timeoutSeconds** (*in query*): integer
304312
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
305313
- **watch** (*in query*): boolean
@@ -339,6 +347,10 @@ GET /apis/rbac.authorization.k8s.io/v1/roles
339347

340348
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
341349

350+
- **sendInitialEvents** (**查询参数**): boolean
351+
352+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
353+
342354
- **timeoutSeconds**（**查询参数**）：integer
343355

344356
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -653,6 +665,8 @@ DELETE /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles
653665
<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion</a>
654666
- **resourceVersionMatch** (*in query*): string
655667
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
668+
- **sendInitialEvents** (*in query*): boolean
669+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
656670
- **timeoutSeconds** (*in query*): integer
657671
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
658672
-->
@@ -704,6 +718,11 @@ DELETE /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles
704718

705719
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
706720

721+
- **sendInitialEvents** (**查询参数**): boolean
722+
723+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
724+
725+
707726
- **timeoutSeconds**（**查询参数**）：integer
708727

709728
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>

‎content/zh-cn/docs/reference/kubernetes-api/workload-resources/cron-job-v1.md

Lines changed: 32 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
120120
<!--
121121
- **timeZone** (string)
122122
123-
The time zone name for the given schedule, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If not specified, this will default to the time zone of the kube-controller-manager process. The set of valid time zone names and the time zone offset is loaded from the system-wide time zone database by the API server during CronJob validation and the controller manager during execution. If no system-wide time zone database can be found a bundled version of the database is used instead. If the time zone name becomes invalid during the lifetime of a CronJob or due to a change in host configuration, the controller will stop creating new new Jobs and will create a system event with the reason UnknownTimeZone. More information can be found in https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones This is beta field and must be enabled via the `CronJobTimeZone` feature gate.
123+
The time zone name for the given schedule, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If not specified, this will default to the time zone of the kube-controller-manager process. The set of valid time zone names and the time zone offset is loaded from the system-wide time zone database by the API server during CronJob validation and the controller manager during execution. If no system-wide time zone database can be found a bundled version of the database is used instead. If the time zone name becomes invalid during the lifetime of a CronJob or due to a change in host configuration, the controller will stop creating new new Jobs and will create a system event with the reason UnknownTimeZone. More information can be found in https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones.
124124
-->
125125

126126
- **timeZone** (string)
@@ -133,12 +133,13 @@ CronJobSpec 描述了作业的执行方式和实际将运行的时间。
133133
如果时区名称在 CronJob 的生命周期内或由于主机配置更改而变得无效，该控制器将停止创建新的 Job，
134134
并将创建一个原因为 UnknownTimeZone 的系统事件。更多信息，请请参阅
135135
https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/cron-jobs/#time-zones。
136-
这是 Beta 字段，必须通过 `CronJobTimeZone` 特性门控启用。
137136

138137
<!--
139138
- **concurrencyPolicy** (string)
140139
141-
Specifies how to treat concurrent executions of a Job. Valid values are: - "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one
140+
Specifies how to treat concurrent executions of a Job. Valid values are:
141+
142+
- "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one
142143
-->
143144

144145
- **concurrencyPolicy** (string)
@@ -501,11 +502,19 @@ GET /apis/batch/v1/namespaces/{namespace}/cronjobs
501502
502503
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
503504
-->
504-
505505
- **resourceVersionMatch** (**查询参数**): string
506506

507507
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
508508

509+
<!--
510+
- **sendInitialEvents** (*in query*): boolean
511+
512+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
513+
-->
514+
- **sendInitialEvents** (**查询参数**): boolean
515+
516+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
517+
509518
<!--
510519
- **timeoutSeconds** (*in query*): integer
511520
@@ -632,11 +641,19 @@ GET /apis/batch/v1/cronjobs
632641
633642
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
634643
-->
635-
636-
- **resourceVersionMatch** (*in query*): string
644+
- **resourceVersionMatch** (**查询参数**): string
637645

638646
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
639647

648+
<!--
649+
- **sendInitialEvents** (*in query*): boolean
650+
651+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
652+
-->
653+
- **sendInitialEvents** (**查询参数**): boolean
654+
655+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
656+
640657
<!--
641658
- **timeoutSeconds** (*in query*): integer
642659
@@ -1430,6 +1447,15 @@ DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs
14301447

14311448
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
14321449

1450+
<!--
1451+
- **sendInitialEvents** (*in query*): boolean
1452+
1453+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1454+
-->
1455+
- **sendInitialEvents** (**查询参数**): boolean
1456+
1457+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1458+
14331459
<!--
14341460
- **timeoutSeconds** (*in query*): integer
14351461

‎content/zh-cn/docs/reference/kubernetes-api/workload-resources/daemon-set-v1.md

Lines changed: 25 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -96,13 +96,14 @@ DaemonSetSpec 是守护进程集的规约。
9696
<!--
9797
- **template** (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec</a>), required
9898
99-
An object that describes the pod that will be created. The DaemonSet will create exactly one copy of this pod on every node that matches the template's node selector (or on every node if no node selector is specified). More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template
99+
An object that describes the pod that will be created. The DaemonSet will create exactly one copy of this pod on every node that matches the template's node selector (or on every node if no node selector is specified). The only allowed template.spec.restartPolicy value is "Always". More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template
100100
-->
101101
- **template** (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec</a>), 必需
102102

103103
描述将要创建的 Pod 的对象。DaemonSet 将在与模板的节点选择器匹配的每个节点上
104-
（如果未指定节点选择器，则在每个节点上）准确创建此 Pod 的副本。
105-
更多信息： https://kubernetes.io/zh-cn/concepts/workloads/controllers/replicationcontroller#pod-template
104+
（如果未指定节点选择器，则在每个节点上）准确创建此 Pod 的副本。`template.spec.restartPolicy`
105+
唯一被允许配置的值是 "Always"。更多信息：
106+
https://kubernetes.io/zh-cn/concepts/workloads/controllers/replicationcontroller#pod-template
106107

107108
<!--
108109
- **minReadySeconds** (int32)
@@ -633,6 +634,10 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets
633634
- **resourceVersionMatch** (*in query*): string
634635
635636
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
637+
638+
- **sendInitialEvents** (*in query*): boolean
639+
640+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
636641
-->
637642

638643
- **resourceVersion** (**查询参数**): string
@@ -643,6 +648,9 @@ GET /apis/apps/v1/namespaces/{namespace}/daemonsets
643648

644649
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
645650

651+
- **sendInitialEvents** (**查询参数**): boolean
652+
653+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
646654
<!--
647655
- **timeoutSeconds** (*in query*): integer
648656
@@ -753,6 +761,10 @@ GET /apis/apps/v1/daemonsets
753761
- **resourceVersionMatch** (*in query*): string
754762
755763
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
764+
765+
- **sendInitialEvents** (*in query*): boolean
766+
767+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
756768
-->
757769

758770
- **resourceVersion** (**查询参数**): string
@@ -763,6 +775,9 @@ GET /apis/apps/v1/daemonsets
763775

764776
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
765777

778+
- **sendInitialEvents** (**查询参数**): boolean
779+
780+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
766781
<!--
767782
- **timeoutSeconds** (*in query*): integer
768783
@@ -1466,6 +1481,10 @@ DELETE /apis/apps/v1/namespaces/{namespace}/daemonsets
14661481
- **resourceVersionMatch** (*in query*): string
14671482
14681483
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
1484+
1485+
- **sendInitialEvents** (*in query*): boolean
1486+
1487+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
14691488
-->
14701489

14711490
- **resourceVersion** (**查询参数**): string
@@ -1476,6 +1495,9 @@ DELETE /apis/apps/v1/namespaces/{namespace}/daemonsets
14761495

14771496
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
14781497

1498+
- **sendInitialEvents** (**查询参数**): boolean
1499+
1500+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
14791501
<!--
14801502
- **timeoutSeconds** (*in query*): integer
14811503

‎content/zh-cn/docs/reference/kubernetes-api/workload-resources/replica-set-v1.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -426,6 +426,10 @@ GET /apis/apps/v1/namespaces/{namespace}/replicasets
426426

427427
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
428428

429+
- **sendInitialEvents** (**查询参数**): boolean
430+
431+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
432+
429433
- **timeoutSeconds** (**查询参数**): integer
430434

431435
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -501,6 +505,10 @@ GET /apis/apps/v1/replicasets
501505

502506
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
503507

508+
- **sendInitialEvents** (**查询参数**): boolean
509+
510+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
511+
504512
- **timeoutSeconds** (**查询参数**): integer
505513

506514
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -965,6 +973,10 @@ DELETE /apis/apps/v1/namespaces/{namespace}/replicasets
965973

966974
<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch</a>
967975

976+
- **sendInitialEvents** (**查询参数**): boolean
977+
978+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
979+
968980
- **timeoutSeconds** (**查询参数**): integer
969981

970982
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>

0 commit comments

Comments
 (0)