- 文档
- 日志
- Query Menu Access Logs
Query Menu Access Logs¶
查询用户的访问菜单操作。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.3/event/log/query
请求参数(URI)¶
| 名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|---|
| orgId | Query | 必需 | String | OU ID。如何获取 orgId 信息 >> | 
请求参数(Body)¶
| 名称 | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|
| startTime | 必需 | Long | 查询开始时间,时间戳格式,精确到毫秒。 | 
| endTime | 必需 | Long | 查询结束时间,时间戳格式,精确到毫秒。 | 
| pagination | 可选 | Pagination 请求结构体 | 分页参数。若不提供,则默认按照每页 1000 条数据的格式返回第 0 页的数据。Pagination 请求结构体>> | 
响应参数¶
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| pagination | pagination 结构体 | 分页信息。pagination 结构体 >> | 
| logs | EventLogDTO 结构体 | 事件列表。EventLogDTO 结构体 >> | 
pagination 结构体 
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| totalElements | Integer | 总记录数。 | 
| pageNo | Integer | 当前页码。 | 
| pageSize | Integer | 当前每页条数。 | 
EventLogDTO 结构体¶
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| subjectId | String | 事件 ID。 | 
| subjectType | String | 事件类型。 | 
| subjectName | String | 事件名称。该参数的值为复杂的多语言结构,在返回时将被序列化成 String 类型,因此返回值中的引号将被转义。后续可对值进行反序列化,解析回 JSON 格式。 | 
| upstreamId | String | 事件的上级对象 ID。仅当该审计记录拥有上级对象时返回。 | 
| upstreamType | String | 事件的上级对象类型。仅当该审计记录拥有上级对象时返回。 | 
| upstreamName | String | 事件的上级对象名称。仅当该审计记录拥有上级对象时返回。 | 
| organizationId | String | 事件所属的 OU ID。 | 
| userId | String | 引发事件的用户 ID。 | 
| eventTime | String | 事件发生的时间。 | 
错误码¶
| 代码 | 描述 | 
|---|---|
| 31400 | OU 未获取应用,时间输入不合法。 | 
| 31404 | OU 不存在。 | 
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.3/event/log/query
method: POST
requestBody:
{
  "pagination":{
    "pageSize":2,
    "pageNo":0
  },
    "startTime": 1660177000000,
    "endTime": 1660177679000
}
返回示例¶
{
  "code": 0,
  "message": "OK",
  "data": {
    "pagination":{
      "totalElements":15000,
      "pageSize":2,
      "pageNo":0
    },
    "logs": [
      {
        "subjectId": "your_subject_id",
        "subjectName": "{\"default\":\"uic\",\"en_US\":\"uic\",\"zh_CN\":\"uic\"}",
        "subjectType": "app",
        "organizationId": "your_org_id",
        "userId": "your_user_id",
        "eventTime": "2022-08-11 08:25:32.0"
      },
      {
        "subjectId": "your_subject_id",
        "subjectName": "{\"default\":\"5180\",\"en_US\":\"5180\",\"zh_CN\":\"8599\"}",
        "subjectType": "menu",
        "upstreamId": "5244f6e8-522c-43f6-af4e-e85753075c69",
        "upstreamType": "app",
        "upstreamName": "{\"default\":\"uic\",\"en_US\":\"uic\",\"zh_CN\":\"uic\"}",
        "organizationId": "your_org_id",
        "userId": "your_user_id",
        "eventTime": "2022-08-11 08:27:57.0"
      }
    ]
  }
}