> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

获取指定时间范围内，企业管理员的操作日志。该接口的响应数据为分页格式。
## 所需权限 {#93f0795e}
`audit`
## 请求方式 {#83235582}
```HTTP
GET /openapi/v1/audit/admin-logs
```

## 请求参数 {#737d61fe}
<!-- @cols-width: 146,146,146,143,282 -->
| | | | | | \
|**参数** |**类型** |**是否必填** |**默认值** |**描述** |
|---|---|---|---|---|
| | | | | | \
|`start_time` |int |是 |\- |开始时间（秒时间戳）。 |
| | | | | | \
|`end_time` |int |是 |\- |结束时间（秒时间戳）。时间跨度最大为 90 天。 |
| | | | | | \
|`page` |int |否 |`1` |需要获取的页数。 |
| | | | | | \
|`page_size` |int |否 |`50` |每页返回的日志条数，最多 200 条。 |
| | | | | | \
|`types` |string |否 |\- |操作类型 ID，用逗号分隔。详见[操作类型参考表](/enterprise/get-admin-logs#54604fe3)。 |
| | | | | | \
|`email` |string |否 |\- |按管理员的邮箱过滤操作日志。 |
| | | | | | \
|`user_id` |string |否 |\- |按管理员的 ID 过滤操作日志。 |\
| | | | |`user_id` 的优先级高于 `email`。 |

## 响应参数 {#21873b66}
<!-- @cols-width: 244,244,356 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`items` |array |当前页返回的日志列表。 |
| | | | \
|`pagination` |object |分页信息，用于控制翻页。 |

`items` 数组包含以下参数：
<!-- @cols-width: 244,244,316 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`log_id` |string |日志 ID。 |
| | | | \
|`operator` |object |操作者的信息。 |
| | | | \
|`operation_type` |int |操作类型 ID。详见[操作类型参考表](/enterprise/get-admin-logs#54604fe3)。 |
| | | | \
|`operation_name` |string |操作类型的名称。 |
| | | | \
|`content` |string |操作详情。 |
| | | | \
|`operation_time` |int64 |操作时间（秒时间戳）。 |

`operator` 对象包含以下参数：
<!-- @cols-width: 244,244,316 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`user_id` |int64 |操作者的 ID。 |
| | | | \
|`name` |string |操作者的姓名。 |
| | | | \
|`email` |string |操作者的邮箱。 |

`pagination` 对象包含以下参数：
<!-- @cols-width: 190,141,321 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`page` |int |当前页码。 |
| | | | \
|`page_size` |int |每页的日志条数。 |
| | | | \
|`total` |int |日志总条数。 |
| | | | \
|`total_pages` |int |总页数。 |

## 请求示例 {#840315e1}
```Bash
curl -X GET "https://{domain}/openapi/v1/audit/admin-logs?start_time=1700000000&end_time=1700086400&page=1&page_size=50" \
  -H "Authorization: Bearer {access_token}"
```

## 响应示例 {#301dbecc}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "items": [
      {
        "log_id": "log_abc123",
        "operator": {
          "user_id": 123456,
          "name": "张三",
          "email": "zhangsan@example.com"
        },
        "operation_type": 1,
        "operation_name": "add_member",
        "content": "添加成员 newuser@example.com 为管理员",
        "operation_time": 1700000000
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total": 100,
      "total_pages": 2
    }
  }
}
```

## 操作类型参考表 {#54604fe3}
<!-- @cols-width: 200,322,334 -->
| | | | \
|**值** |**操作名称** |**描述** |
|---|---|---|
| | | | \
|1 |`add_member` |添加成员。 |
| | | | \
|2 |`remove_member` |删除成员。 |
| | | | \
|3 |`modify_permission` |修改成员的权限。 |
| | | | \
|4 |`transfer_admin` |移交超级管理员权限。 |
| | | | \
|5 |`modify_info` |修改成员的信息。 |
| | | | \
|7 |`modify_company_quota` |修改企业整体 Token 限额。 |
| | | | \
|8 |`generate_invite_link` |生成邀请链接。 |
| | | | \
|9 |`join_request` |成员通过链接邀请尝试申请加入后，审批该申请。 |
| | | | \
|10 |`member_join` |成员接受发出的邮件邀请，加入了企业。 |
| | | | \
|11 |`activate_member` |激活成员。 |
| | | | \
|12 |`login` |登录 TRAE。 |
| | | | \
|13 |`logout` |登出 TRAE。 |
| | | | \
|14 |`export_ide` |导出 TRAE IDE 相关的数据。 |
| | | | \
|16 |`quota_modify` |修改人均 Token 限额。 |
| | | | \
|17 |`sso_config` |SSO 配置相关操作。 |
| | | | \
|18 |`force_sso_login` |强制 SSO 登录相关操作。 |
| | | | \
|19 |`model_config` |模型配置相关操作。 |
| | | | \
|20 |`export_data` |导出数据分析报表。 |
| | | | \
|21 |`export_audit_log` |导出审计日志。 |
| | | | \
|24 |`add_repository_limit` |将代码仓库添加至访问限制名单。 |
| | | | \
|25 |`remove_repository_limit` |将代码仓库从访问限制名单中移除。 |
| | | | \
|26 |`modify_domain_config` |在火山引擎的 TRAE 控制台中，为访问控制配置专属域名。 |
| | | | \
|27 |`add_team_document` |新增企业文档集。 |
| | | | \
|28 |`modify_team_document` |修改企业文档集。 |
| | | | \
|29 |`delete_team_document` |删除企业文档集。 |
| | | | \
|30 |`modify_domain_whitelist` |在火山引擎的 TRAE 控制台中，为访问控制中的公网访问配置白名单 ID。 |
| | | | \
|31 |`modify_domain_whitelist_status` |在火山引擎的 TRAE 控制台中，为访问控制开启或关闭公网访问。 |
| | | | \
|40 |`publish_agent` |发布企业智能体。 |
| | | | \
|41 |`delete_agent` |删除企业智能体。 |
| | | | \
|42 |`toggle_agent_status` |启用或禁用企业智能体。 |
| | | | \
|43 |`modify_system_model_quota` |修改系统内置模型的使用限额。 |
| | | | \
|44 |`modify_custom_model_quota` |修改企业自定义模型的使用限额。 |
| | | | \
|45 |`create_login_token` |创建登录令牌。 |
| | | | \
|46 |`revoke_login_token` |撤销登录令牌。 |
| | | | \
|50 |`add_content_security_rule` |新增内容安全策略。 |
| | | | \
|51 |`delete_content_security_rule` |删除内容安全策略。 |
| | | | \
|52 |`enable_content_security_rule` |启用内容安全策略。 |
| | | | \
|53 |`disable_content_security_rule` |停用内容安全策略。 |
| | | | \
|54 |`update_content_security_rule` |更新内容安全策略。 |
| | | | \
|55 |`hit_content_security_rule` |命中内容安全策略。 |
| | | | \
|60 |`add_command_blacklist` |新增命令黑名单。 |
| | | | \
|61 |`remove_command_blacklist` |移除命令黑名单。 |
| | | | \
|62 |`hit_command_blacklist` |命中命令黑名单。 |
| | | | \
|70 |`add_mcp_whitelist` |新增 MCP 白名单。 |
| | | | \
|71 |`delete_mcp_whitelist` |删除 MCP 白名单。 |
| | | | \
|72 |`enable_mcp_whitelist` |启用白名单中的 MCP。 |
| | | | \
|73 |`disable_mcp_whitelist` |关停白名单中的 MCP。 |
| | | | \
|74 |`update_mcp_whitelist` |修改白名单中的 MCP。 |
| | | | \
|75 |`toggle_mcp_whitelist_global` |开启/关闭 MCP 白名单全局开关。 |