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

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

## 所需权限 {#93f0795e}

`audit:read`

## 请求说明 {#83235582}

* 请求方式：`GET`
* 请求地址：`{域名}/openapi/v1/audit/admin-logs`

## 注意事项 {#hiOXTNqTH}

时间跨度最大为 90 天。

## 请求参数 {#请求参数}

### 请求头参数 {#请求头参数}

<!-- @cols-width: 172,122,596 -->
| **Header 参数**  | **是否必填**  | **描述**  |
| --- | --- | --- |
| `Authorization`  | 是  | 固定取值为 `Bearer {access_token}`。关于如何获取访问令牌，参考[鉴权](enterprise_authentication)。  |

### 查询参数 {#737d61fe}

<!-- @cols-width: 146,113,118,101,390 -->
| **参数**  | **类型**  | **是否必填**  | **默认值**  | **描述**  |
| --- | --- | --- | --- | --- |
| `start_time`  | int  | 是  | \-  | 开始时间，Unix 秒级时间戳。  |
| `end_time`  | int  | 是  | \-  | 结束时间，Unix 秒级时间戳。  |
| `types`  | string  | 否  | \-  | 操作类型 ID，用逗号分隔。详见[操作类型参考表](/enterprise/get-admin-logs#54604fe3)。  |
| `user_id`  | string  | 否  | \-  | 按操作者的 ID 过滤操作日志。`user_id` 的优先级高于 `email`。 | \
| | | | | | \
| | | | | 操作者的 ID 可以通过 “[获取成员列表](/enterprise_get-user-list)” 接口获取。  |
| `email`  | string  | 否  | \-  | 按操作者的邮箱过滤操作日志。 | \
| | | | | | \
| | | | | 操作者的邮箱可以通过 “[获取成员列表](/enterprise_get-user-list)” 接口获取。  |
| `page`  | int  | 否  | `1`  | 需要获取的页数。  |
| `page_size`  | int  | 否  | `50`  | 每页返回的日志条数。取值范围：[1, 200]。  |

## 响应参数 {#21873b66}

该接口独有的响应参数如下，参数位于 `data` 中。通用响应参数参考[此文档](/enterprise_general-response-schema)。

<!-- @cols-width: 244,244,376 -->
| **参数**  | **类型**  | **描述**  |
| --- | --- | --- |
| `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。详见[操作类型参考表](/enterprise/get-admin-logs#54604fe3)。  |
| `items[].operation_name`  | string  | 操作类型的名称。  |
| `items[].content`  | string  | 操作详情。  |
| `items[].operation_time`  | int64  | 操作时间，Unix 秒级时间戳。  |

## 示例 {#示例}

### 请求示例 {#840315e1}

```Bash
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}"
```

### 响应示例 {#301dbecc}

```JSON
{
  "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
    }
  }
}
```

## 操作类型参考表 {#54604fe3}

<!-- @cols-width: 200,322,334 -->
| **`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`  | 修改基础池耗尽前允许提前按量配置。  |

## 错误码 {#错误码}

若该接口的请求返回错误码，参考[错误码](/enterprise_error-codes)文档进行排查。