AI 助手
TRAE 智能问答助手
你好,我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些?
如何创建自定义智能体?
如何配置 Rules?
文档反馈

获取管理员操作日志

获取指定时间范围内,企业管理员的操作日志。

所需权限

audit:read

请求说明

  • 请求方式:GET
  • 请求地址:{域名}/openapi/v1/audit/admin-logs

注意事项

时间跨度最大为 90 天。

请求参数

请求头参数

Header 参数 是否必填 描述
Authorization 固定取值为 Bearer {access_token}。关于如何获取访问令牌,参考鉴权

查询参数

参数 类型 是否必填 默认值 描述
start_time int - 开始时间,Unix 秒级时间戳。
end_time int - 结束时间,Unix 秒级时间戳。
types string - 操作类型 ID,用逗号分隔。详见操作类型参考表

user_id

string

-

按操作者的 ID 过滤操作日志。user_id 的优先级高于 email

操作者的 ID 可以通过 “获取成员列表” 接口获取。

email

string

-

按操作者的邮箱过滤操作日志。

操作者的邮箱可以通过 “获取成员列表” 接口获取。

page int 1 需要获取的页数。
page_size int 50 每页返回的日志条数。取值范围:[1, 200]。

响应参数

该接口独有的响应参数如下,参数位于 data 中。通用响应参数参考此文档

参数 类型 描述
items array 结果列表。
items[].log_id string 日志 ID。
items[].operator object 操作者的信息。
items[].operator.user_id int64 操作者的 ID。
items[].operator.user_id_str string 操作者 ID 的字符串形式。
items[].operator.email string 操作者的邮箱。
items[].operator.name string 操作者的姓名。
items[].operation_type int 操作类型 ID。详见操作类型参考表
items[].operation_name string 操作类型的名称。
items[].content string 操作详情。
items[].operation_time int64 操作时间,Unix 秒级时间戳。

示例

请求示例

curl -X GET "${HOST}/openapi/v1/audit/admin-logs?start_time=1780000000&end_time=1780600000&types=121,122&page=1" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "items": [
      {
        "log_id": "log_abc123",
        "operator": {
          "user_id": 123456,
          "user_id_str": "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
    }
  }
}

操作类型参考表

operation_type operation_name 描述
1 add_member 添加成员。
2 remove_member 删除成员。
3 modify_permission 修改成员的权限。
4 transfer_admin 移交超级管理员权限。
5 modify_info 修改成员的信息。
6 modify_quota 修改成员的 Token 配额。
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 导出 TraeCode 相关的数据。
15 privacy_mode 隐私模式相关操作。
16 quota_modify 修改人均 Token 限额。
17 sso_config SSO 配置相关操作。
18 force_sso_login 强制 SSO 登录相关操作。
19 model_config 模型配置相关操作。
20 export_data 导出数据分析报表。
21 export_audit_log 导出审计日志。
22 modify_public_dns_whitelist 修改 VPC 公共 DNS 白名单。
23 modify_public_dns_status 开启或关闭 VPC 公网访问。
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 白名单全局开关。
80 create_openapi_key 创建应用凭证。
81 delete_openapi_key 删除应用凭证。
82 update_openapi_key 修改应用凭证调用范围。
83 toggle_openapi_key 启用或禁用应用凭证。
90 modify_user_model_quota 批量修改用户模型配额。
91 create_enterprise_hook 创建企业 Hook。
92 update_enterprise_hook 修改企业 Hook。
93 delete_enterprise_hook 删除企业 Hook。
94 enable_enterprise_hook 启用企业 Hook。
95 disable_enterprise_hook 禁用企业 Hook。
96 create_enterprise_sandbox_policy 创建企业沙箱策略。
97 update_enterprise_sandbox_policy 编辑企业沙箱策略。
98 delete_enterprise_sandbox_policy 删除企业沙箱策略。
99 enable_enterprise_sandbox_policy 启用企业沙箱策略。
100 disable_enterprise_sandbox_policy 停用企业沙箱策略。
101 modify_ai_code_tracking_config 修改 AI 代码追踪配置。
102 delete_enterprise_skill 删除企业技能。
103 toggle_enterprise_skill 启用或禁用企业技能。
104 toggle_third_party_skill 切换三方技能开关。
105 create_enterprise_skill 创建企业技能。
106 reclaim_seat 回收席位。
107 add_member_no_invite 添加成员但不发送邀请。
110 create_department 创建部门。
111 rename_department 重命名部门。
112 move_department 移动部门。
113 delete_department 删除部门。
114 modify_member_department 修改成员归属的部门。
115 send_member_invite 发送成员邀请。
116 modify_department 修改部门名称或其直属的部门。
121 account_type_change 修改成员账号类型。
122 modify_early_paygo_config 修改基础池耗尽前允许提前按量配置。

错误码

若该接口的请求返回错误码,参考错误码文档进行排查。