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

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

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

检索审计事件

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

$ curl 'http://localhost:8080/actuator/auditevents?principal=alice&after=2024-10-03T19%3A30%3A03.317346084Z&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-10-03T19:30:03.317879211Z",
    "principal" : "alice",
    "type" : "logout"
  } ]
}

查询参数

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

参数 描述

afterspring-doc.cn

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

principalspring-doc.cn

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

typespring-doc.cn

将事件限制为具有给定类型的事件。自选。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
参数 描述

afterspring-doc.cn

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

principalspring-doc.cn

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

typespring-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