Management API

审计日志

---

GET /audit/teams/{teamId}/events

GET 请求到 /audit/teams/{teamId}/events 的 API 端点。

路径参数

• teamId (字符串, 必需) — 要获取事件的团队 ID。

查询参数

• pageSize (整数) — 每页列出的事件数量。

• pageToken (字符串) — 查询下一页时的偏移令牌。

• eventFilter.userId (字符串) — 仅筛选此用户的事件。

• eventFilter.query (字符串) — 用于全文描述搜索的通用搜索词。

• eventFilter.eventId (字符串) — 按 ID 搜索特定事件。

• eventTimeFrom (字符串) — 从特定时间和/或到特定时间筛选事件（可选）。

• eventTimeTo (字符串)

• orderBy ("TIME_ASCENDING" | "TIME_DESCENDING")

响应体

• events (array<object>) — 请求的事件。按 event_time 排序。

  • eventTime (字符串)

  • eventId (字符串) — 引用此日志的标识符。与系统中的其他内容无绑定。

  • description (字符串) — 事件的自由形式英文描述。

  • user (对象)

    • userId (字符串) — 用户 ID。

    • email (字符串) — 用户邮箱。可能不总是填充。

    • profileImage (字符串) — 从我们的资产服务器获取个人资料的密钥。 TODO(pohlen): 这应该是个人资料图片的 URL。

    • givenName (字符串) — 用户的名字。

    • familyName (字符串) — 用户的姓氏。

    • profileImageUrl (字符串) — 用户个人资料的完整 URL 路径。

• nextPageToken (字符串) — 如果有更多事件，用于检索搜索结果下一页的令牌。

**响应示例：**

{
  "events": [
    {
      "eventTime": "2025-01-15T10:30:00Z",
      "eventId": "550e8400-e29b-41d4-a716-446655440000",
      "description": "API key 'Production Key' was created",
      "user": {
        "userId": "user-123",
        "email": "admin@example.com",
        "givenName": "John",
        "familyName": "Doe"
      }
    }
  ],
  "nextPageToken": "550e8400-e29b-41d4-a716-446655440000"
}