审计日志查询 - listAuditLogs
功能介绍
审计日志查询
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/auditlog
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释： 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} 约束限制： 不涉及 取值范围： 不涉及 默认值： 不涉及 |
| X-Traceid | 否 | String | 参数解释： 业务跟踪id（必须58位） 约束限制： 不涉及 取值范围： 长度为58位 默认值： 不涉及 |
| language | 否 | String | 参数解释： 国际化语言标识 约束限制： 符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语 取值范围： 符合i18n规范 默认取值： en-US |
| X-User-Id | 是 | String | 参数解释： KooDrive侧用户id，用于app鉴权 约束限制： 不涉及 取值范围： 不涉及 默认值： 不涉及 |
| X-Date | 是 | String | 参数解释： 日期，用于app鉴权 约束限制： 日期格式：yyyyMMDD'T'HHmmss'Z' ; 例如20251103T070140Z 取值范围： 距当前时间15分钟以内，不能晚于当前时间 默认值： 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| operTimeFrom | 否 | String | 参数解释： 起始操作时间 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| operTimeTo | 否 | String | 参数解释： 终止操作时间 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| operatorName | 否 | String | 参数解释： 操作者账号名 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| operations | 否 | Array of strings | 参数解释： 需要搜索的操作类型,支持多个操作类型筛选 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| excludedOperations | 否 | Array of strings | 参数解释： 需要排除在外操作类型,支持多个操作类型筛选 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| operateResult | 否 | String | 参数解释： 操作结果 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| operatorIP | 否 | String | 参数解释： 操作者IP地址 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| pageInfo | 否 | PageInfo object | 参数解释： 分页信息 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| sortInfo | 否 | SortInfo object | 参数解释： 排序信息 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 响应码 |
| msg | String | 响应信息 |
| total | Integer | 列表总数 |
| logInfoList | Array of LogInfo objects | 审计日志列表 |
请求示例
分页查询审计日志请求示例
POST /koodrive/ose/v1/auditlog
{
"operTimeFrom" : "2025-01-01T00:00:01.000Z",
"operTimeTo" : "2026-01-01T00:00:01.000Z",
"operatorName" : "",
"operations" : [ ],
"excludedOperations" : [ ],
"operateResult" : "",
"operatorIp" : "",
"pageInfo" : {
"pageSize" : 10,
"pageNum" : 0
},
"sortInfo" : {
"sortType" : 1,
"sortDirection" : 2
}
} 响应示例
状态码：200
分页查询审计日志响应
{
"total" : 184645,
"logInfoList" : [ {
"logId" : "1734826883142633601",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "lrz1209",
"operatorId" : "1605107125384798848",
"operateTime" : "2025-07-21T09:58:48.000Z",
"operation" : "getFile",
"resource" : "FnNpiVn_Vkqt3sG2mc6lPC4qc419xV-Wr",
"operateResult" : 0,
"operatorIP" : "127.0.0.1"
}, {
"logId" : "1734826882849032320",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "lrz1209",
"operatorId" : "1605107125384798848",
"operateTime" : "2025-07-21T09:58:33.000Z",
"operation" : "getFile",
"resource" : "resource is null",
"operateResult" : 1,
"message" : "缩略图字段的最大大小为5。",
"operatorIP" : "127.0.0.1"
}, {
"logId" : "1734826882530265216",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "lrz1209",
"operatorId" : "1605107125384798848",
"operateTime" : "2025-07-21T09:58:25.000Z",
"operation" : "getFile",
"resource" : "resource is null",
"operateResult" : 1,
"message" : "没有权限",
"operatorIP" : "127.0.0.1"
}, {
"logId" : "1734859178008241024",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:30.000Z",
"operation" : "SearchFile",
"resource" : "1",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
}, {
"logId" : "1734859177127437185",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:29.976Z",
"operation" : "GetUser",
"resource" : "1605107117323346560",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
}, {
"logId" : "1734859176976442112",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:29.958Z",
"operation" : "getSpaceByContainerId",
"resource" : "1605107117323346560",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
}, {
"logId" : "1734859174552134529",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:29.669Z",
"operation" : "GetUser",
"resource" : "1605107117323346560",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
}, {
"logId" : "1734859174426305280",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:29.654Z",
"operation" : "getSpaceByContainerId",
"resource" : "1605107117323346560",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
}, {
"logId" : "1734859171641287553",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:29.322Z",
"operation" : "GetUser",
"resource" : "1605107117323346560",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
}, {
"logId" : "1734859171481903872",
"tenantId" : "ee33a28d0f454801b4532233258822e4",
"operatorName" : "hid42638091",
"operatorId" : "1605107117323346560",
"operateTime" : "2025-07-21T07:35:29.303Z",
"operation" : "getSpaceByContainerId",
"resource" : "1605107117323346560",
"operateResult" : 0,
"operatorIP" : "10.69.250.244"
} ],
"code" : 0,
"msg" : "success"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 分页查询审计日志响应 |
