启动操作日志导出任务

接口地址

/task/export/startExportAuditlog

说明

导出任务启动接口，调用后立即返回。服务端在后台发起了一个导出的任务，在导出任务队列中排队，导出任务被串行执行。

注意：此接口返回，不代表导出任务执行完成，只表明发起一个导出任务。导出任务一般执行时间较长，需要后续通过导出进度查询接口，每隔一段时间查询某个导出任务的执行进度。任务完成后导出进度查询接口会返回任务状态为已完成，并包含导出文件下载路径。

导出任务进度查询接口是已有接口，为导出任务进度查询(/task/export/status)，请参考对应接口文档。

导出文件字段说明

导出文件与操作日志页面导出的文件的字段一致。

接口调用限制

1. 接口允许的调用时间，为下午19点以后, 至早上7点之间。其他时间端调本接口报错。
2. 5分钟内，同一调用参数只允许调用1次。
3. 每次导出请求，操作日期跨度最大范围为1年。
4. 导出文件数据量最大100万，超过会被截断，因此建议不要导出日期范围太大。如果导出的数据量为100万整，则可能数据是不全的。建议根据调用方每日操作日志数据量，适当调整参数中的日期范围。

入参

字段说明

名称	类型	必填	示例	描述
beginOpDate	String	是	"2020-01-01"	操作日期，开始。 格式 yyyy-MM-dd
endOpDate	String	是	"2020-01-31"	操作日期，结束。 格式 yyyy-MM-dd

JSON 示例

{
  "paramValues": [
    {
      "beginOpDate": "2021-04-14",
      "endOpDate": "2025-04-16"
    }
  ]
}

出参

字段说明

名称	类型	示例	描述
taskId	Number	121212	导出任务id， 标识一次导出任务。指定任务id, 可调用导出任务进度查询接口，查看任务进度和结果。 因数值较大，为避免精度丢失，请使用大整数类型，比如Java的BigInteger。

JSON 示例

{
  "code": 200,//200为正常，其他代码为错误
  "message": "SUCCESS",
  "data": {
    "taskId": 10102
  }
}

当code为非200值时，message表示具体的错误信息：

message	对应场景
结清日期跨度超过限制，最多365天！	接口调用限制3
系统繁忙，请在下午19点以后, 至早上7点之间调用本接口！	接口调用限制1