[zh] Sync audit-annotations.md and _index.md

windsonsea · windsonsea · commit f2c19cb078b8 · 2025-05-14T21:45:57.000+08:00
diff --git a/content/zh-cn/docs/reference/labels-annotations-taints/_index.md b/content/zh-cn/docs/reference/labels-annotations-taints/_index.md
@@ -326,7 +326,7 @@ defining them has the `applyset.kubernetes.io/is-parent-type` label.
 用于：作为 ApplySet 父对象使用的对象。
 
 此注解处于 Alpha 阶段。
-对于 Kubernetes {{< skew currentVersion >}} 版本， 如果定义它们的
+对于 Kubernetes {{< skew currentVersion >}} 版本，如果定义它们的
 {{< glossary_tooltip term_id="CustomResourceDefinition" text="CustomResourceDefinition" >}}
 打了 `applyset.kubernetes.io/is-parent-type` 标签，
 那么你可以在 Secret、ConfigMap 或自定义资源上使用此注解。
@@ -418,7 +418,7 @@ defining them has the `applyset.kubernetes.io/is-parent-type` label.
 用于：作为 ApplySet 父对象使用的对象。
 
 此注解处于 Alpha 阶段。
-对于 Kubernetes {{< skew currentVersion >}} 版本， 如果定义它们的
+对于 Kubernetes {{< skew currentVersion >}} 版本，如果定义它们的
 {{< glossary_tooltip term_id="CustomResourceDefinition" text="CustomResourceDefinition" >}}
 打了 `applyset.kubernetes.io/is-parent-type` 标签，那么你可以在 Secret、ConfigMap 或自定义资源上使用此注解。
 
@@ -462,7 +462,7 @@ not being a valid parent for ApplySets, omit this label.
 
 示例：`applyset.kubernetes.io/is-parent-type: "true"`
 
-用于：自定义资源 （CRD）
+用于：自定义资源（CRD）
 
 此注解处于 Alpha 阶段。
 规范的部分功能用来实现[在 kubectl 中基于 ApplySet 的删除](/zh-cn/docs/tasks/manage-kubernetes-objects/declarative-config/#alternative-kubectl-apply-f-directory-prune)。
@@ -497,7 +497,7 @@ label on the parent object.
 此注解处于 Alpha 阶段。
 规范的部分功能用来实现[在 kubectl 中基于 ApplySet 的删除](/zh-cn/docs/tasks/manage-kubernetes-objects/declarative-config/#alternative-kubectl-apply-f-directory-prune)。
 此标签使对象成为 ApplySet 的成员。
-标签的值 **必须** 与父对象上的 `applyset.kubernetes.io/id` 标签的值相匹配。
+标签的值**必须**与父对象上的 `applyset.kubernetes.io/id` 标签的值相匹配。
 
 <!--
 ### applyset.kubernetes.io/tooling (alpha) {#applyset-kubernetes-io-tooling}
@@ -522,7 +522,7 @@ ConfigMaps, or custom resources if the CustomResourceDefinitiondefining them has
 用于：作为 ApplySet 父对象使用的对象。
 
 此注解处于 Alpha 阶段。
-对于 Kubernetes {{< skew currentVersion >}} 版本， 如果定义它们的
+对于 Kubernetes {{< skew currentVersion >}} 版本，如果定义它们的
 {{< glossary_tooltip term_id="CustomResourceDefinition" text="CustomResourceDefinition" >}}
 打了 `applyset.kubernetes.io/is-parent-type` 标签，那么你可以在 Secret、ConfigMap 或自定义资源上使用此注解。
 
@@ -535,7 +535,7 @@ The value must be in the format `<toolname>/<semver>`.
 -->
 规范的部分功能用来实现[在 kubectl 中基于 ApplySet 的删除](/zh-cn/docs/tasks/manage-kubernetes-objects/declarative-config/#alternative-kubectl-apply-f-directory-prune)。
 此注解应用于父对象，这些父对象用于跟踪 ApplySet 以指示哪个工具管理 ApplySet。
-工具应该拒绝改变属于其他工具 ApplySets。
+工具应该拒绝改变属于其他工具的 ApplySet。
 该值必须采用 `<toolname>/<semver>` 格式。
 
 ### apps.kubernetes.io/pod-index (beta) {#apps-kubernetes.io-pod-index}
@@ -783,7 +783,8 @@ This annotation records the result of bind scheduler plugins, used by https://si
 
 用于：Pod
 
-此注解记录了 bind 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 bind 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/filter-result
@@ -810,7 +811,8 @@ This annotation records the result of filter scheduler plugins, used by https://
 -->
 用于：Pod
 
-此注解记录了 filter 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 filter 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/finalscore-result
@@ -838,7 +840,8 @@ used by https://sigs.k8s.io/kube-scheduler-simulator.
 -->
 用于：Pod
 
-此注解记录了调度器从 score 调度插件计算出的最终分数，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了调度器从 score 调度插件计算出的最终分数，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 ```yaml
 kube-scheduler-simulator.sigs.k8s.io/finalscore-result: >-
@@ -864,7 +867,8 @@ This annotation records the result of permit scheduler plugins, used by https://
 
 用于：Pod
 
-此注解记录了 permit 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 permit 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/permit-result-timeout
@@ -885,7 +889,8 @@ This annotation records the timeouts returned from permit scheduler plugins, use
 
 用于：Pod
 
-此注解记录了 permit 调度插件返回的超时时间，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 permit 调度插件返回的超时时间，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/postfilter-result
@@ -906,7 +911,8 @@ This annotation records the result of postfilter scheduler plugins, used by http
 
 用于：Pod
 
-此注解记录了 postfilter 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 postfilter 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/prebind-result
@@ -927,7 +933,8 @@ This annotation records the result of prebind scheduler plugins, used by https:/
 
 用于：Pod
 
-此注解记录了 prebind 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 prebind 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/prefilter-result
@@ -948,7 +955,8 @@ This annotation records the PreFilter result of prefilter scheduler plugins, use
 
 用于：Pod
 
-此注解记录了 prefilter 调度插件的预过滤结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 prefilter 调度插件的预过滤结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/prefilter-result-status
@@ -975,7 +983,8 @@ This annotation records the result of prefilter scheduler plugins, used by https
 -->
 用于：Pod
 
-此注解记录了 prefilter 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 prefilter 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/prescore-result
@@ -1002,7 +1011,8 @@ This annotation records the result of prefilter scheduler plugins, used by https
 -->
 用于：Pod
 
-此注解记录了 prefilter 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator
+此注解记录了 prefilter 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/reserve-result
@@ -1023,7 +1033,8 @@ This annotation records the result of reserve scheduler plugins, used by https:/
 
 用于：Pod
 
-此注解记录了 reserve 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 reserve 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/result-history
@@ -1044,7 +1055,8 @@ This annotation records all the past scheduling results from scheduler plugins,
 
 用于：Pod
 
-此注解记录了所有过去的调度插件的调度结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了所有过去的调度插件的调度结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/score-result
@@ -1069,7 +1081,8 @@ This annotation records the result of score scheduler plugins, used by https://s
 -->
 用于：Pod
 
-此注解记录了 score 调度插件的结果，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了 score 调度插件的结果，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### kube-scheduler-simulator.sigs.k8s.io/selected-node
@@ -1090,7 +1103,8 @@ This annotation records the node that is selected by the scheduling cycle, used
 
 用于：Pod
 
-此注解记录了调度周期选择的节点，用于 https://sigs.k8s.io/kube-scheduler-simulator。
+此注解记录了调度周期选择的节点，用于
+[kube-scheduler-simulator](https://sigs.k8s.io/kube-scheduler-simulator)。
 
 <!--
 ### internal.config.kubernetes.io/index
@@ -1115,7 +1129,7 @@ value of 0 is implied.
 用于：所有对象
 
 该注解记录了包含对象的 YAML 文档在加载对象的清单文件中的零索引位置。
-请注意，YAML 文档由三个破折号（---）分隔，每个文档可以包含一个对象。
+请注意，YAML 文档由三个破折号（`---`）分隔，每个文档可以包含一个对象。
 如果未指定此注解，则该值为 0。
 
 <!--
diff --git a/content/zh-cn/docs/reference/labels-annotations-taints/audit-annotations.md b/content/zh-cn/docs/reference/labels-annotations-taints/audit-annotations.md
@@ -13,7 +13,7 @@ This page serves as a reference for the audit annotations of the kubernetes.io
 namespace. These annotations apply to `Event` object from API group
 `audit.k8s.io`.
 -->
-该页面作为 kubernetes.io 名字空间的审计注解的参考。这些注解适用于 API 组
+本页面作为 kubernetes.io 名字空间的审计注解的参考。这些注解适用于 API 组
 `audit.k8s.io` 中的 `Event` 对象。
 
 {{< note >}}
@@ -26,9 +26,8 @@ The annotations apply to audit events. Audit events are different from objects i
 `events.k8s.io`).
 -->
 Kubernetes API 中不使用以下注解。当你在集群中[启用审计](/zh-cn/docs/tasks/debug/debug-cluster/audit/)时，
-审计事件数据将使用 API 组 `audit.k8s.io` 中的 `Event` 写入。
-注解适用于审计事件。
-审计事件不同于[事件 API](/zh-cn/docs/reference/kubernetes-api/cluster-resources/event-v1/)
+审计事件数据将使用 API 组 `audit.k8s.io` 中的 `Event` 写入。此注解适用于审计事件。
+审计事件不同于 [Event API](/zh-cn/docs/reference/kubernetes-api/cluster-resources/event-v1/)
 （API 组 `events.k8s.io`）中的对象。
 {{</note>}}
 
@@ -53,14 +52,14 @@ request used a deprecated API version.
 
 Example: `k8s.io/removed-release: "1.22"`
 
-Value **must** be in the format "<major>.<minor>". It is set to target the removal release
+Value **must** be in the format "\<MAJOR>\.\<MINOR>\". It is set to target the removal release
 on requests made to deprecated API versions with a target removal release.
 -->
-## k8s.io/removed-release {#k8s-io-removed-release} 
+## k8s.io/removed-release {#k8s-io-removed-release}
 
 例子：`k8s.io/removed-release: "1.22"`
 
-值**必须**为 "<major>.<minor>" 的格式。当请求使用了已弃用的 API 版本时，
+值**必须**为 "\<MAJOR>\.\<MINOR>\" 的格式。当请求使用了已弃用的 API 版本时，
 该值会被设置为目标移除的版本。
 
 <!--
@@ -77,7 +76,7 @@ from the PodSecurity enforcement.
 
 例子：`pod-security.kubernetes.io/exempt: namespace`
 
-值**必须**是对应于 [Pod 安全豁免](/zh-cn/docs/concepts/security/pod-security-admission/#exemptions)维度的 
+值**必须**是对应于 [Pod 安全豁免](/zh-cn/docs/concepts/security/pod-security-admission/#exemptions)维度的
 `user`、`namespace` 或 `runtimeClass` 之一。
 此注解指示 PodSecurity 基于哪个维度的强制豁免执行。
 
@@ -134,6 +133,57 @@ PodSecurity 执行中违反的特定策略及对应字段。
 
 有关详细信息，请参阅 [Pod 安全标准](/zh-cn/docs/concepts/security/pod-security-standards/)。
 
+<!--
+## apiserver.latency.k8s.io/etcd
+
+Example: `apiserver.latency.k8s.io/etcd: "4.730661757s"`
+
+This annotation indiactes the measure of latency incurred inside the storage layer,
+it accounts for the time it takes to send data to the etcd and get the complete response back.
+
+The value of this audit annotation does not include the time incurred in admission, or validation.
+-->
+## apiserver.latency.k8s.io/etcd
+
+例子：`apiserver.latency.k8s.io/etcd: "4.730661757s"`
+
+此注解表示在存储层内部产生的延迟测量，  
+它记录将数据发送到 etcd 并接收完整响应所花费的时间。
+
+此审计注解的取值不包括准入或校验过程所耗用的时间。
+
+<!--
+## apiserver.latency.k8s.io/decode-response-object
+
+Example: `apiserver.latency.k8s.io/decode-response-object: "450.6649ns"`
+
+This annotation records the time taken to decode the response received from the storage layer (etcd)
+-->
+## apiserver.latency.k8s.io/decode-response-object
+
+例子：`apiserver.latency.k8s.io/decode-response-object: "450.6649ns"`
+
+此注解记录解码从存储层（etcd）接收到的响应对象所花费的时间。
+
+<!--
+## apiserver.latency.k8s.io/apf-queue-wait
+
+Example: `apiserver.latency.k8s.io/apf-queue-wait: "100ns"`
+
+This annotation records the time that a request spent queued due to API server priorities.
+
+See [API Priority and Fairness](/docs/concepts/cluster-administration/flow-control/) (APF)
+for more information about this mechanism.
+-->
+## apiserver.latency.k8s.io/apf-queue-wait
+
+例子：`apiserver.latency.k8s.io/apf-queue-wait: "100ns"`
+
+此注解记录由于 API 服务器优先级机制，请求在队列中等待的时间。
+
+有关此机制的更多信息，参见
+[API 优先级与公平性](/zh-cn/docs/concepts/cluster-administration/flow-control/)（APF）。
+
 <!--
 ## authorization.k8s.io/decision
 
@@ -179,15 +229,15 @@ Used by Kubernetes version v1.24 and later
 -->
 例子：`missing-san.invalid-cert.kubernetes.io/example-svc.example-namespace.svc: "relies on a legacy Common Name field instead of the SAN extension for subject validation"`
 
-由 Kubernetes v1.24 及更高版本使用
+由 Kubernetes v1.24 及更高版本使用。
 
 <!--
 This annotation indicates a webhook or aggregated API server
 is using an invalid certificate that is missing `subjectAltNames`.
 Support for these certificates was disabled by default in Kubernetes 1.19,
 and removed in Kubernetes 1.23.
 -->
-此注解表示 webhook 或聚合 API 服务器正在使用缺少 `subjectAltNames` 的无效证书。
+此注解表示 Webhook 或聚合 API 服务器正在使用缺少 `subjectAltNames` 的无效证书。
 Kubernetes 1.19 已经默认禁用，且 Kubernetes 1.23 已经移除对这些证书的支持。
 
 <!--
@@ -209,20 +259,20 @@ Go 文档中有更多关于此的信息：
 
 <!--
 Example: `insecure-sha1.invalid-cert.kubernetes.io/example-svc.example-namespace.svc: "uses an insecure SHA-1 signature"`
+
 Used by Kubernetes version v1.24 and later
 -->
-
 例子：`insecure-sha1.invalid-cert.kubernetes.io/example-svc.example-namespace.svc: "uses an insecure SHA-1 signature"`
 
-由 Kubernetes v1.24 及更高版本使用
+由 Kubernetes v1.24 及更高版本使用。
 
 <!--
 This annotation indicates a webhook or aggregated API server
 is using an insecure certificate signed with a SHA-1 hash.
 Support for these insecure certificates is disabled by default in Kubernetes 1.24,
 and will be removed in a future release.
 -->
-此注解表示 webhook 或聚合 API 服务器所使用的是使用 SHA-1 签名的不安全证书。
+此注解表示 Webhook 或聚合 API 服务器所使用的是使用 SHA-1 签名的不安全证书。
 Kubernetes 1.24 已经默认禁用，并将在未来的版本中删除对这些证书的支持。
 
 <!--
@@ -243,10 +293,7 @@ Go 文档中有更多关于此的信息：
 <!--
 Example: `validation.policy.admission.k8s.io/validation_failure: '[{"message": "Invalid value", {"policy": "policy.example.com", {"binding": "policybinding.example.com", {"expressionIndex": "1", {"validationActions": ["Audit"]}]'`
 -->
-例子：`validation.policy.admission.k8s.io/validation_failure:
-'[{"message": "Invalid value", {"policy": "policy.example.com",
-{"binding": "policybinding.example.com", {"expressionIndex": "1",
-{"validationActions": ["Audit"]}]'`
+例子：`validation.policy.admission.k8s.io/validation_failure: '[{"message": "Invalid value", {"policy": "policy.example.com", {"binding": "policybinding.example.com", {"expressionIndex": "1", {"validationActions": ["Audit"]}]'`
 
 <!--
 Used by Kubernetes version v1.27 and later.
@@ -286,4 +333,3 @@ for more details about `validationActions`.
 `validationActions` 显示针对此验证失败采取的操作。
 有关 `validationActions` 的更多详细信息，
 请参阅[验证准入策略](/zh-cn/docs/reference/access-authn-authz/validating-admission-policy/)。
-
