diff --git a/content/zh/docs/reference/config-api/apiserver-audit.v1.md b/content/zh/docs/reference/config-api/apiserver-audit.v1.md index 245096e999..e7bc19c4f6 100644 --- a/content/zh/docs/reference/config-api/apiserver-audit.v1.md +++ b/content/zh/docs/reference/config-api/apiserver-audit.v1.md @@ -34,7 +34,9 @@ auto_generated: true +
Event 结构包含可出现在 API 审计日志中的所有信息。 +
字段 | 描述 |
+ 生成事件所对应的审计级别。 + |
---|---|---|
auditID [必需]- k8s.io/apimachinery/pkg/types.UID
+k8s.io/apimachinery/pkg/types.UID
|
+ 为每个请求所生成的唯一审计 ID。 + |
+ 生成此事件时请求的处理阶段。 + |
@@ -75,7 +83,9 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+ requestURI 是客户端发送到服务器端的请求 URI。 + |
@@ -86,7 +96,9 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+ verb 是与请求对应的 Kubernetes 动词。对于非资源请求,此字段为 HTTP 方法的小写形式。 + |
@@ -95,7 +107,9 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+ 关于认证用户的信息。 + |
@@ -104,7 +118,9 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+ 关于所伪装(impersonated)的用户的信息。 + |
@@ -112,8 +128,37 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
-
+
+ 发起请求和中间代理的源 IP 地址。 + 源 IP 从以下(按顺序)列出: + +
|
@@ -124,8 +169,10 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+ userAgent 中记录客户端所报告的用户代理(User Agent)字符串。 注意 userAgent 信息是由客户端提供的,一定不要信任。 + |
@@ -135,7 +182,9 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+ 此请求所指向的对象引用。对于 List 类型的请求或者非资源请求,此字段可忽略。 + |
@@ -146,40 +195,46 @@ Event 结构包含可出现在 API 审计日志中的所有信息。
+
requestObject - k8s.io/apimachinery/pkg/runtime.Unknown
+k8s.io/apimachinery/pkg/runtime.Unknown
|
+ 来自请求的 API 对象,以 JSON 格式呈现。requestObject 在请求中按原样记录 (可能会采用 JSON 重新编码),之后会进入版本转换、默认值填充、准入控制以及 配置信息合并等阶段。此对象为外部版本化的对象类型,甚至其自身可能并不是一个 合法的对象。对于非资源请求,此字段被忽略。 - 只有当审计级别为 Request 或更高的时候才会记录。 + 只有当审计级别为 Request 或更高的时候才会记录。 + |
|
responseObject - k8s.io/apimachinery/pkg/runtime.Unknown
+k8s.io/apimachinery/pkg/runtime.Unknown
|
+ 响应中包含的 API 对象,以 JSON 格式呈现。requestObject 是在被转换为外部类型 并序列化为 JSON 格式之后才被记录的。 对于非资源请求,此字段会被忽略。 只有审计级别为 Response 时才会记录。 + |
+ 请求到达 API 服务器时的时间。 + |
@@ -197,7 +254,9 @@ at Response Level.-->
+ 请求到达当前审计阶段时的时间。 + |
@@ -211,6 +270,7 @@ at Response Level.-->
to the metadata.annotations of the submitted object. Keys should uniquely identify the informing
component to avoid name collisions (e.g. podsecuritypolicy.admission.k8s.io/policy). Values
should be short. Annotations are included in the Metadata level.-->
+
字段 | 描述 |
---|
字段 | 描述 |
+
包含 metadata 字段的详细信息。
|
@@ -297,11 +364,13 @@ Policy 定义的是审计日志的配置以及不同类型请求的日志记录
A request may match multiple rules, in which case the FIRST matching rule is used.
The default audit level is None, but can be overridden by a catch-all rule at the end of the list.
PolicyRules are strictly ordered.-->
+
+ 字段 omitStages 是一个阶段(Stage)列表,其中包含无须生成事件的阶段。 注意这一选项也可以通过每条规则来设置。 审计组件最终会忽略出现在 omitStages 中阶段,也会忽略规则中的阶段。 + + |
+
+
+
+
---|---|---|
+omitManagedFields + bool
+ |
+
+
+ +omitManagedFields 标明将请求和响应主体写入 API 审计日志时,是否省略其托管字段。 +此字段值用作全局默认值 - 'true' 值将省略托管字段,否则托管字段将包含在 API 审计日志中。 +请注意,也可以按规则指定此值,在这种情况下,规则中指定的值将覆盖全局默认值。 + |
字段 | 描述 |
---|
字段 | 描述 |
-
- 字段 resources 是此规则所适用的资源的列表。 +'∗/scale' matches all scale subresources. +--> + + 字段 resources 是此规则所适用的资源的列表。 + ++
例如: + + 如果存在通配符,则合法性检查逻辑会确保 resources 中的条目不会彼此重叠。 + ++ 空的列表意味着规则适用于该 API 组中的所有资源及其子资源。 + |
@@ -416,9 +525,11 @@ For example:
+
---|
字段 | 描述 | |
---|---|---|
uid - k8s.io/apimachinery/pkg/types.UID
+k8s.io/apimachinery/pkg/types.UID
|
资源对象的唯一标识(UID)。 @@ -500,8 +615,10 @@ ObjectReference 包含的是用来检查或修改所引用对象时将需要的 |
+
字段 apiGroup 给出包含所引用对象的 API 组的名称。
空字符串代表 |
+ 字段 apiVersion 是包含所引用对象的 API 组的版本。 + |
@@ -545,8 +664,10 @@ ObjectReference 包含的是用来检查或修改所引用对象时将需要的
PolicyRule maps requests based off metadata to an audit Level.
Requests must match the rules of every field (an intersection of rules).
-->
+
字段 | 描述 |
+ 与此规则匹配的请求所对应的日志记录级别(Level)。 + |
@@ -567,8 +690,10 @@ PolicyRule 包含一个映射,基于元数据将请求映射到某审计级别
+ 根据身份认证所确定的用户名的列表,给出此规则所适用的用户。 空列表意味着适用于所有用户。 + |
@@ -579,8 +704,10 @@ PolicyRule 包含一个映射,基于元数据将请求映射到某审计级别
+
+ 此规则所适用的动词(verb)列表。 空列表意味着适用于所有动词。 + |
@@ -600,8 +729,10 @@ PolicyRule 包含一个映射,基于元数据将请求映射到某审计级别
+ 此规则所适用的资源类别列表。 空列表意味着适用于 API 组中的所有资源类别。 + |
@@ -610,12 +741,14 @@ PolicyRule 包含一个映射,基于元数据将请求映射到某审计级别
+ |
---|---|
nonResourceURLs @@ -627,11 +760,13 @@ PolicyRule 包含一个映射,基于元数据将请求映射到某审计级别 Examples: "/metrics" - Log requests for apiserver metrics "/healthz∗" - Log all health checks--> +
字段 nonResourceURLs 给出一组需要被审计的 URL 路径。
允许使用 ∗,但只能作为路径中最后一个完整分段。 |
|
omitManagedFields + bool
+ |
+
+
+ + omitManagedFields 决定将请求和响应主体写入 API 审计日志时,是否省略其托管字段。 + +
|
+
Stage 定义在请求处理过程中可以生成审计事件的阶段。 +