# 审计日志查询 - listAuditLogs
#### 功能介绍
审计日志查询
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/auditlog
#### 请求参数
表1请求Body参数 
| 参数                 | 是否必选 | 参数类型                                                | 描述                    |
|:---|:---|:---|:---|
| 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 | 排序信息                  |
   
 表2PageInfo 
| 参数       | 是否必选 | 参数类型    | 描述                |
|:---|:---|:---|:---|
| pageSize | 是    | Integer | 1-100 ,默认10 最大100 |
| pageNum  | 是    | Integer | 具体页码信息            |
   
 表3SortInfo 
| 参数            | 是否必选 | 参数类型    | 描述                 |
|:---|:---|:---|:---|
| sortType      | 否    | Integer | 排序类型，1：操作时间（默认）    |
| sortDirection | 否    | Integer | 排序方向，1：升序，2：降序（默认） |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数          | 参数类型                                                         | 描述     |
|:---|:---|:---|
| code        | String                                                       | 响应码    |
| msg         | String                                                       | 响应信息   |
| total       | Integer                                                      | 列表总数   |
| logInfoList | Array of [LogInfo] objects | 审计日志列表 |
   
 表5LogInfo 
| 参数            | 参数类型    | 描述        |
|:---|:---|:---|
| logId         | String  | 日志ID      |
| tenantId      | String  | 租户ID      |
| operatorName  | String  | 操作者账号名    |
| operatorId    | String  | 操作者Id     |
| operateTime   | String  | 操作时间      |
| operation     | String  | 操作类型      |
| resource      | String  | 操作对象,资源ID |
| operateResult | Integer | 操作结果      |
| operatorIP    | String  | 操作者IP     |
| message       | String  | 失败原因      |
   
#### 请求示例
分页查询审计日志请求示例
```
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 | 分页查询审计日志响应 |