NATSaudit.log.query检索审计日志

Try it 面板需要启用 JavaScript。

用户侧与管理侧共用的检索入口：携带 userId 即限定该用户，另可按动作、结果与时间窗过滤。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	No	按行为主体过滤
action	string	No	按动作过滤，如 auth.login.password
resource	string	No	按资源过滤
result	string	No	success / failure
since	string	No	起始时间（ISO 8601 UTC）
until	string	No	结束时间（ISO 8601 UTC）
page	number	No	页码，默认 1
pageSize	number	No	每页数量，默认 20，上限 100

type RequestBody = {
  /** 按行为主体过滤 */
  userId?: string
  /** 按动作过滤，如 auth.login.password */
  action?: string
  /** 按资源过滤 */
  resource?: string
  /** success / failure */
  result?: string
  /** 起始时间（ISO 8601 UTC） */
  since?: string
  /** 结束时间（ISO 8601 UTC） */
  until?: string
  /** 页码，默认 1 */
  page?: number
  /** 每页数量，默认 20，上限 100 */
  pageSize?: number
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "action": "auth.login.password",
  "page": 1,
  "pageSize": 20
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
items	array	Yes	日志列表
total	number	Yes	总数
page	number	Yes	当前页码
pageSize	number	Yes	每页数量

type ResponseBody = {
  /** 日志列表 */
  items: Record<string, unknown>[]
  /** 总数 */
  total: number
  /** 当前页码 */
  page: number
  /** 每页数量 */
  pageSize: number
}

{
  "items": [
    {
      "logId": "01JD8SNXER6Y9Z5FZ",
      "actorId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
      "action": "auth.login.password",
      "resource": "user/01JD8SEGQ0P9N2XK4L7VDH3T6C",
      "result": "failure",
      "ip": "198.51.100.7",
      "detail": "密码错误",
      "occurredAt": "2026-10-14T07:58:12Z"
    }
  ],
  "total": 3,
  "page": 1,
  "pageSize": 20
}

Response Code

回复使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	检索审计日志

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "action": "auth.login.password", "page": 1, "pageSize": 20 }

{
  "id": "01JD8SXEQN5R7TP",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "logId": "01JD8SNXER6Y9Z5FZ",
        "actorId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
        "action": "auth.login.password",
        "resource": "user/01JD8SEGQ0P9N2XK4L7VDH3T6C",
        "result": "failure",
        "ip": "198.51.100.7",
        "detail": "密码错误",
        "occurredAt": "2026-10-14T07:58:12Z"
      }
    ],
    "total": 3,
    "page": 1,
    "pageSize": 20
  }
}