Skip to content

Commit 05f29d5

Browse files
committed
[zh-cn] sync object-meta audit-annotations service-v1.md
Signed-off-by: xin.li <[email protected]>
1 parent 176eb18 commit 05f29d5

File tree

3 files changed

+97
-14
lines changed

3 files changed

+97
-14
lines changed

content/zh-cn/docs/reference/kubernetes-api/common-definitions/object-meta.md

+15-11
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,12 @@ ObjectMeta 是所有持久化资源必须具有的元数据,其中包括用户
3333
- **name** (string)
3434

3535
<!--
36-
Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names
36+
Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
3737
-->
38+
3839
name 在命名空间内必须是唯一的。创建资源时需要,尽管某些资源可能允许客户端请求自动地生成适当的名称。
3940
名称主要用于创建幂等性和配置定义。无法更新。更多信息:
40-
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/names/
41+
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/names#names
4142

4243
- **generateName** (string)
4344

@@ -64,34 +65,34 @@ ObjectMeta 是所有持久化资源必须具有的元数据,其中包括用户
6465
<!--
6566
Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.
6667
67-
Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces
68+
Must be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces
6869
-->
6970

7071
namespace 定义了一个值空间,其中每个名称必须唯一。空命名空间相当于 “default” 命名空间,但 “default” 是规范表示。
7172
并非所有对象都需要限定在命名空间中——这些对象的此字段的值将为空。
7273

7374
必须是 DNS_LABEL。无法更新。更多信息:
74-
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/namespaces/
75+
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/namespaces
7576

7677
- **labels** (map[string]string)
7778

7879
<!--
79-
Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels
80+
Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels
8081
-->
8182

8283
可用于组织和分类(确定范围和选择)对象的字符串键和值的映射。
8384
可以匹配 ReplicationController 和 Service 的选择算符。更多信息:
84-
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/
85+
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels
8586

8687
- **annotations** (map[string]string)
8788

8889
<!--
89-
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations
90+
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations
9091
-->
9192

9293
annotations 是一个非结构化的键值映射,存储在资源中,可以由外部工具设置以存储和检索任意元数据。
9394
它们不可查询,在修改对象时应保留。更多信息:
94-
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/annotations/
95+
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/annotations
9596

9697
<!-- ### System {#System} -->
9798
### 系统字段 {#System}
@@ -256,13 +257,15 @@ ObjectMeta 是所有持久化资源必须具有的元数据,其中包括用户
256257

257258
- **ownerReferences.name** (string),<!-- required -->必选
258259

259-
<!-- Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names -->
260+
<!-- Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names-->
261+
260262
被引用资源的名称。更多信息:
261263
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/names/
262264

263265
- **ownerReferences.uid** (string),<!-- required -->必选
264266

265-
<!-- UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids -->
267+
<!-- UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids -->
268+
266269
被引用资源的 uid。更多信息:
267270
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/names#uids
268271

@@ -384,8 +387,9 @@ ObjectMeta 是所有持久化资源必须具有的元数据,其中包括用户
384387
<!--
385388
UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.
386389
387-
Populated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids
390+
Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
388391
-->
392+
389393
UID 是该对象在时间和空间上的唯一值。它通常由服务器在成功创建资源时生成,并且不允许使用 PUT 操作更改。
390394

391395
由系统填充。只读。更多信息:

content/zh-cn/docs/reference/kubernetes-api/service-resources/service-v1.md

+27
Original file line numberDiff line numberDiff line change
@@ -856,6 +856,15 @@ GET /api/v1/namespaces/{namespace}/services
856856

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

859+
<!--
860+
- **sendInitialEvents** (*in query*): boolean
861+
862+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
863+
-->
864+
- **sendInitialEvents** (**查询参数**): boolean
865+
866+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
867+
859868
- **timeoutSeconds****查询参数**):integer
860869

861870
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -924,6 +933,15 @@ GET /api/v1/services
924933

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

936+
<!--
937+
- **sendInitialEvents** (*in query*): boolean
938+
939+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
940+
-->
941+
- **sendInitialEvents** (**查询参数**): boolean
942+
943+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
944+
927945
- **timeoutSeconds****查询参数**):integer
928946

929947
<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -1367,6 +1385,15 @@ DELETE /api/v1/namespaces/{namespace}/services
13671385

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

1388+
<!--
1389+
- **sendInitialEvents** (*in query*): boolean
1390+
1391+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1392+
-->
1393+
- **sendInitialEvents** (**查询参数**): boolean
1394+
1395+
<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
1396+
13701397
- **timeoutSeconds****查询参数**):integer
13711398

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

content/zh-cn/docs/reference/labels-annotations-taints/audit-annotations.md

+55-3
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,8 @@ This page serves as a reference for the audit annotations of the kubernetes.io
1313
namespace. These annotations apply to `Event` object from API group
1414
`audit.k8s.io`.
1515
-->
16-
该页面作为 kubernetes.io 名字空间的审计注解的参考。这些注解适用于 API 组 `audit.k8s.io` 中的 `Event` 对象。
16+
该页面作为 kubernetes.io 名字空间的审计注解的参考。这些注解适用于 API 组
17+
`audit.k8s.io` 中的 `Event` 对象。
1718

1819
{{< note >}}
1920
<!--
@@ -69,7 +70,7 @@ for more information.
6970

7071
例子:`pod-security.kubernetes.io/enforce-policy: restricted:latest`
7172

72-
**必须**是对应于 [Pod 安全标准](/zh-cn/docs/concepts/security/pod-security-standards) 级别的
73+
**必须**是对应于 [Pod 安全标准](/zh-cn/docs/concepts/security/pod-security-standards)级别的
7374
`privileged:<版本>``baseline:<版本>``restricted:<版本>`
7475
关联的版本**必须**`latest` 或格式为 `v<MAJOR>.<MINOR>` 的有效 Kubernetes 版本。
7576
此注解通知有关在 PodSecurity 准入期间允许或拒绝 Pod 的执行级别。
@@ -97,7 +98,8 @@ for more information.
9798
PodSecurity "restricted:latest": allowPrivilegeEscalation != false (container
9899
"example" must set securityContext.allowPrivilegeEscalation=false), ...`
99100

100-
注解值给出审计策略违规的详细说明,它包含所违反的 [Pod 安全标准](/zh-cn/docs/concepts/security/pod-security-standards/)级别以及
101+
注解值给出审计策略违规的详细说明,它包含所违反的
102+
[Pod 安全标准](/zh-cn/docs/concepts/security/pod-security-standards/)级别以及
101103
PodSecurity 执行中违反的特定策略及对应字段。
102104

103105
有关详细信息,请参阅 [Pod 安全标准](/zh-cn/docs/concepts/security/pod-security-standards/)
@@ -203,3 +205,53 @@ There's more information about this in the Go documentation:
203205
-->
204206
Go 文档中有更多关于此的信息:
205207
[拒绝 SHA-1 证书](https://go.dev/doc/go1.18#sha1)
208+
209+
## validation.policy.admission.k8s.io/validation_failure
210+
211+
<!--
212+
Example: `validation.policy.admission.k8s.io/validation_failure: '[{"message": "Invalid value", {"policy": "policy.example.com", {"binding": "policybinding.example.com", {"expressionIndex": "1", {"validationActions": ["Audit"]}]'`
213+
-->
214+
例子:`validation.policy.admission.k8s.io/validation_failure:
215+
'[{"message": "Invalid value", {"policy": "policy.example.com",
216+
{"binding": "policybinding.example.com", {"expressionIndex": "1",
217+
{"validationActions": ["Audit"]}]'`
218+
219+
<!--
220+
Used by Kubernetes version v1.27 and later.
221+
222+
This annotation indicates that a admission policy validation evaluted to false
223+
for an API request, or that the validation resulted in an error while the policy
224+
was configured with `failurePolicy: Fail`.
225+
-->
226+
由 Kubernetes v1.27 及更高版本使用。
227+
228+
此注解表示 API 请求的准入策略验证评估为 false,
229+
或者当策略配置为 `failurePolicy: Fail` 时验证报错。
230+
231+
<!--
232+
The value of the annotation is a JSON object. The `message` in the JSON
233+
provides the message about the validation failure.
234+
-->
235+
注解的值是一个 JSON 对象。JSON 中的 `message`
236+
字段提供了有关验证失败的信息。
237+
238+
<!--
239+
The `policy`, `binding` and `expressionIndex` in the JSON identifies the
240+
name of the `ValidatingAdmissionPolicy`, the name of the
241+
`ValidatingAdmissionPolicyBinding` and the index in the policy `validations` of
242+
the CEL expressions that failed, respectively.
243+
-->
244+
JSON 中的 `policy``binding``expressionIndex`
245+
分别标识了 `ValidatingAdmissionPolicy` 的名称、
246+
`ValidatingAdmissionPolicyBinding` 的名称以及失败的
247+
CEL 表达式在策略 `validations` 中的索引。
248+
249+
<!--
250+
The `validationActions` shows what actions were taken for this validation failure.
251+
See [Validating Admission Policy](/docs/reference/access-authn-authz/validating-admission-policy/)
252+
for more details about `validationActions`.
253+
-->
254+
`validationActions` 显示针对此验证失败采取的操作。
255+
有关 `validationActions` 的更多详细信息,
256+
请参阅[验证准入策略](/zh-cn/docs/reference/access-authn-authz/validating-admission-policy/)
257+

0 commit comments

Comments
 (0)