跳到主要内容

查询操作日志

分页查询 NineData 操作审计日志。此接口需要 Audit 模块权限。

请求地址:/openapi/v1/actionTrail/list

请求方法:GET

请求参数​

参数类型是否必填说明
accountIdString否账号 ID;不传查询全部账号。
startTimeDateTime否操作时间范围开始时间,ISO 8601 格式,例如 2025-07-31T09:12:30Z。
endTimeDateTime否操作时间范围结束时间,ISO 8601 格式。
moduleString否所属模块,取值见下表。
typeString否事件类型,取值见下表。
objectIdString否事件对象 ID。
currentInteger否当前页,从 1 开始,默认 1。
pageSizeInteger否每页记录数,默认 10,最大 1000。

模块取值​

sqlWindow、dsql、sqlTask、dataGenerate、sqlExport、dataExport、dataImport、dataArchive、sqlReview、dataTrack、slowLog、sqlReadSensitive、sqlWriteSensitive、backupTask、restore、backupQuery、replicationTask、compareData、compareSchema、datasourceOperate、gateway、accesscredential、privatelink、user、role、organization、permissionApply、ruleSet、rule、approval、reportManage、group、flow、externalApplication 或 externalApproval。

事件类型取值​

create、modify、delete、execute、revert、cancel、export、transfer、login、download、enable、disable、debug、start、suspend 或 stop。

返回参数​

参数类型说明
successBoolean请求是否成功。
requestIdString请求 ID。
currentInteger当前页。
pageSizeInteger页大小。
totalInteger总数。
dataArray操作日志详情列表。
data[].trailIdString日志 ID。
data[].eventTimeDateTime操作时间。
data[].accountIdString账号 ID。
data[].accountNameString账号名称。
data[].moduleString所属模块。
data[].typeString事件类型。
data[].objectIdString事件对象 ID。
data[].detailString事件详情。

调用成功示例​

{
"success": true,
"requestId": "<requestId>",
"current": 1,
"pageSize": 10,
"total": 1,
"data": [{
"trailId": "<trailId>",
"eventTime": "2026-07-30T10:00:00Z",
"accountId": "<accountId>",
"accountName": "example-user",
"module": "datasourceOperate",
"type": "create",
"objectId": "<datasourceId>",
"detail": "<detail>"
}]
}