跳转到内容
For the complete documentation index, see llms.txt. This page is also available as Markdown.

DescribeLogs

1. 接口描述

本接口(DescribeLogs)用于查询审计日志列表。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称
必选
类型
描述

startTime

是

String

开始时间。

时间格式:yyyy-MM-ddTHH🇲🇲ssZ。

endTime

是

String

结束时间。

时间格式:yyyy-MM-ddTHH🇲🇲ssZ。

开始时间不能大于结束时间;开始时间和结束时间的间隔不能超过30天;开始时间不能超过90天前。

cursor

否

Array of Integer

下一页的游标。

当请求完该页数据后,响应结果中会返回下一页的游标,当需要获取下一页数据时,请求参数需要加上该页返回的游标,依次循环,可以获取到该段时间内的所有数据。

例如:请求当页返回: "cursor": [1691028715371],请求下一页时将[1691028715371]赋值给cursor。

resUid

否

String

资源ID。

resEvent

否

String

事件名称。

clientIP

否

String

客户端操作IP。

size

否

Integer

返回的分页大小。

默认为20,最大为1000。

可选值范围:[1, 1000]

3. 响应结果

参数名称
类型
描述

requestId

String

唯一请求 ID。

每次请求都会返回。定位问题时需要提供该次请求的 requestId。

dataSet

Array of LogInfo

结果集。

cursor

Array of Integer

下一页的游标。

当请求完该页数据后,响应结果中会返回下一页的游标,当需要获取下一页数据时,请求参数需要加上该页返回的游标,依次循环,可以获取到该段时间内的所有数据。

例如:请求当页返回: "cursor": [1691028715371],请求下一页时将[1691028715371]赋值给cursor。

4. 代码示例

1. 查询指定时间范围内的审计日志。

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集(SDK),未来会陆续支持更多开发语言,方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码,其他错误码见公共错误码

HTTP状态码
错误码
说明

400

INVALID_TIME_FORMAT

时间参数格式非法。时间参数不符合格式:yyyy-MM-ddTHH🇲🇲ssZ。

400

INVALID_PARAMETER_ILLEGAL_TIME

时间参数数据非法。开始时间不能大于结束时间;开始时间和结束时间的间隔不能超过30天;开始时间不能超过90天前。

400

INVALID_PARAMETER__TEAM_CANNOT_BE_NULL

团队ID不能为空。

最后更新于