<a id="audit-operations"></a>

# `audit` 操作

<!-- i18n: source=docs/reference/operations/audit.md blob=3784ae0eeadc2b668a2bddeec8f9dc890a7690f1 model=claude-sonnet-5-5 -->
> 本页由机器从[英文原文](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/audit.md)翻译，内容以英文原文为准。
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/audit.md), which is authoritative.


每个 `audit.*` 操作接受和返回的确切字段。

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

每个 op 都是 HTTP 上的 `POST /v1/<op>`，也是 MCP 工具 `loom_<op>`。身份字段（`org`、`namespace`、`agent`、`user_id`、`session_id`）在传输层能够提供时，由令牌和 MCP 会话填充；对于单用户服务器上不带令牌的 HTTP 调用，除 `code.*` 和 `tracker.*`（它们保留各自平面的 org）之外，所有 op 都使用该安装的 org，并且在[部分 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) 上还会填充其命名空间和 agent；参见[身份与命名空间](/zh-CN/concepts/identities-and-namespaces)。[操作索引](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)解释了角色、类型以及 MCP 的 `all` 列表。未知的输入字段仍会被处理，并在 `ignored_args` 中列出。

<!-- prettier-ignore-start -->

<a id="auditlist"></a>

## `audit.list`

查询审计日志（每行带有防篡改哈希）。

`POST /v1/audit.list` · MCP `loom_audit_list` · 角色 `viewer` · 读取 · 未列在 MCP `all` 工具集中

| 输入字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `org` | `str` | 必填 | 租户（身份元组的第一个元素）。 |
| `namespace` | `str \| None` | `None` | None：调用方可读取的所有命名空间；指定一个其无权读取的命名空间会返回空页。 |
| `event_type` | `str \| None` | `None` | 精确匹配 |
| `since` | `datetime \| None` | `None` | 仅返回 ts >= since 的行 |
| `limit` | `int` | `50` | 每页最多返回的行数，按最新优先；范围 1 到 500。 |
| `cursor` | `str \| None` | `None` | 来自上一页的不透明令牌 |
| `fields` | `list[str] \| None` | `None` | 调用方要读取的输出字段（白名单，依据行模型解析；未知名称会返回 422）；未设置时返回所有字段。 |

| 输出字段 | 类型 | 含义 |
| --- | --- | --- |
| `rows` | `list[AuditListRow]` | 审计行的一页，按最新优先（相同时间按 `request_id` 排序）。 |
| `next_cursor` | `str \| None` | 作为 `cursor` 传回以获取下一页（更早的一页）；当前页为最后一页时为 None。 |

<!-- prettier-ignore-end -->
