# 查看操作日志概览

汇总当前身份在当前工作区的操作记录数量，便于快速了解成功和失败操作的数量。本接口不返回具体操作记录，也不支持筛选。

```text
GET https://moi.matrixorigin.cn/newmoi/audit/logs/overview
```

## 调用前准备

准备有当前工作区访问权限的[个人访问令牌](../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)和[当前工作区 ID](../../../../guides/ai-studio/resource-center/workspace.md#复制工作区-id)。

## 请求示例

```bash
curl "https://moi.matrixorigin.cn/newmoi/audit/logs/overview" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"
```

## 成功响应

成功时返回 HTTP 200 和当前身份的操作记录汇总。

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "total": 3,
    "success": 2,
    "failed": 1
  }
}
```

响应字段如下。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | string | 成功时为 OK。 |
| msg | string | 成功时为 OK。 |
| data.total | integer | 操作记录总数。 |
| data.success | integer | 成功操作数量。 |
| data.failed | integer | 失败操作数量。 |

## 错误响应

错误响应使用 code、msg 和 data 包络，data 为 null。msg 为服务端返回的本地化公共错误信息，不应依赖其文本进行程序判断。

```json
{
  "code": "ErrServer",
  "msg": "服务内部错误",
  "data": null
}
```

### 常见 HTTP 错误

```{list-table}
:header-rows: 1
:widths: 12 22 32 34

* - HTTP 状态码
  - 错误代码
  - 常见原因
  - 建议操作
* - 500
  - ErrTenantDBConnection
  - 服务无法取得当前工作区的日志存储连接。
  - 稍后重试；持续出现时联系支持人员。
* - 500
  - ErrServer
  - 服务无法完成操作日志概览查询。
  - 记录请求时间、HTTP 状态和错误代码后重试；持续出现时联系支持人员。
```

## 后续操作

需要查看具体操作时，使用[查看操作日志](list-operation-logs.md#筛选操作日志)。
