此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.4.0！spring-doc.cn

审核事件（`auditevents`)

终端节点提供有关应用程序的审核事件的信息。auditeventsspring-doc.cn

检索审计事件

要检索审计事件，请向发出请求，如以下基于 curl 的示例所示：GET/actuator/auditeventsspring-doc.cn

$ curl 'http://localhost:8080/actuator/auditevents?principal=alice&after=2024-11-29T09%3A49%3A21.508767479Z&type=logout' -i -X GET

前面的示例检索委托人的事件，这些事件发生在 UTC 时区的 2017 年 11 月 7 日 09：37 之后。生成的响应类似于以下内容：logoutalicespring-doc.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 127

{
  "events" : [ {
    "timestamp" : "2024-11-29T09:49:21.509800727Z",
    "principal" : "alice",
    "type" : "logout"
  } ]
}

查询参数

终端节点使用查询参数来限制它返回的事件。下表显示了支持的查询参数：spring-doc.cn

参数描述

参数	描述
`after`spring-doc.cn	将事件限制为在给定时间之后发生的事件。自选。spring-doc.cn
`principal`spring-doc.cn	将事件限制为具有给定主体的事件。自选。spring-doc.cn
`type`spring-doc.cn	将事件限制为具有给定类型的事件。自选。spring-doc.cn

afterspring-doc.cn

将事件限制为在给定时间之后发生的事件。自选。spring-doc.cn

principalspring-doc.cn

将事件限制为具有给定主体的事件。自选。spring-doc.cn

typespring-doc.cn

将事件限制为具有给定类型的事件。自选。spring-doc.cn

响应结构

响应包含与查询匹配的所有审核事件的详细信息。下表描述了响应的结构：spring-doc.cn

路径类型描述

路径	类型	描述
`events`spring-doc.cn	`Array`spring-doc.cn	审计事件数组。spring-doc.cn
`events.[].timestamp`spring-doc.cn	`String`spring-doc.cn	事件发生时的时间戳。spring-doc.cn
`events.[].principal`spring-doc.cn	`String`spring-doc.cn	触发事件的主体。spring-doc.cn
`events.[].type`spring-doc.cn	`String`spring-doc.cn	事件的类型。spring-doc.cn

eventsspring-doc.cn

Arrayspring-doc.cn

审计事件数组。spring-doc.cn

events.[].timestampspring-doc.cn

Stringspring-doc.cn

事件发生时的时间戳。spring-doc.cn

events.[].principalspring-doc.cn

Stringspring-doc.cn

触发事件的主体。spring-doc.cn

events.[].typespring-doc.cn

Stringspring-doc.cn

事件的类型。spring-doc.cn