Skip to content

Commit 1857828

Browse files
author
Tim Bannister
committed
Revert pull request 33842
This reverts commit a5907b3 due to an issue that has caused build failures. Verified locally.
1 parent e657a33 commit 1857828

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

content/zh/docs/reference/using-api/api-concepts.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1066,6 +1066,8 @@ string, working as an enum, and the only accepted values are:
10661066
`All`
10671067
: Every stage runs as normal, except for the final storage stage where side effects
10681068
are prevented.
1069+
1070+
For example:
10691071
-->
10701072
### 发起试运行请求 {#make-a-dry-run-request}
10711073

@@ -1138,11 +1140,11 @@ generated fields may differ.
11381140
Some values of an object are typically generated before the object is persisted. It is important not to rely upon the values of these fields set by a dry-run request, since these values will likely be different in dry-run mode from when the real request is made. Some of these fields are:
11391141
11401142
* `name`: if `generateName` is set, `name` will have a unique random name
1141-
* `creationTimestamp` / `deletionTimestamp`: records the time of creation/deletion
1142-
* `UID`: [uniquely identifies](/docs/concepts/overview/working-with-objects/names/#uids) the object and is randomly generated (non-deterministic)
1143+
* `creationTimestamp`/`deletionTimestamp`: records the time of creation/deletion
1144+
* `UID`: uniquely identifies the object and is randomly generated (non-deterministic)
11431145
* `resourceVersion`: tracks the persisted version of the object
11441146
* Any field set by a mutating admission controller
1145-
* For the `Service` resource: Ports or IP addresses that the kube-apiserver assigns to Service objects
1147+
* For the `Service` resource: Ports or IPs that kube-apiserver assigns to v1.Service objects
11461148
-->
11471149
### 生成值 {#generated-values}
11481150

@@ -1151,12 +1153,11 @@ Some values of an object are typically generated before the object is persisted.
11511153
值很可能不同。这类字段有:
11521154

11531155
* `name`:如果设置了 `generateName` 字段,则 `name` 会获得一个唯一的随机名称
1154-
* `creationTimestamp` / `deletionTimestamp`:记录对象的创建/删除时间
1155-
* `UID`[唯一标识](/zh/docs/concepts/overview/working-with-objects/names/#uids)对象,
1156-
取值随机生成(非确定性)
1156+
* `creationTimestamp`/`deletionTimestamp`:记录对象的创建/删除时间
1157+
* `UID`:唯一性标识对象,取值随机生成(非确定性)
11571158
* `resourceVersion`: 跟踪对象的持久化(存储)版本
11581159
* 变更性准入控制器所设置的字段
1159-
* 对于 `Service` 资源:`kube-apiserver``Service` 对象分配的端口和 IP 地址
1160+
* 对于 `Service` 资源:`kube-apiserver``v1.Service` 对象分配的端口和 IP
11601161

11611162
<!--
11621163
### Dry-run authorization
@@ -1337,6 +1338,8 @@ This table explains the behavior of **list** requests with various combinations
13371338

13381339
下表解释了具有各种 `resourceVersion` 和 `resourceVersionMatch` 组合的 **list** 请求的行为:
13391340
<!--
1341+
{{</* table caption="resourceVersionMatch and paging parameters for list" */>}}
1342+
13401343
| resourceVersionMatch param | paging params | resourceVersion not set | resourceVersion="0" | resourceVersion="{value other than 0}" |
13411344
|---------------------------------------|-------------------------------|-----------------------|-------------------------------------------|----------------------------------------|
13421345
| _unset_ | _limit unset_ | Most Recent | Any | Not older than |
@@ -1347,7 +1350,11 @@ This table explains the behavior of **list** requests with various combinations
13471350
| `resourceVersionMatch=NotOlderThan` | _limit unset_ | Invalid | Any | Not older than |
13481351
| `resourceVersionMatch=NotOlderThan` | limit=\<n\>, _continue unset_ | Invalid | Any | Not older than |
13491352

1350-
{{< /table >}}
1353+
{{</* /table */>}}
1354+
1355+
**Footnotes:**
1356+
1357+
[1] If the server does not honor the `resourceVersionMatch` parameter, it is treated as if it is unset.
13511358
-->
13521359

13531360
{{< table caption="list 操作的 resourceVersionMatch 与分页参数" >}}

0 commit comments

Comments
 (0)