- 文档
- 日志
- 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"
}
]
}
}