创建下载日志接口
更新时间：2025-12-11
接口描述
用于提交下载查询日志
权限说明
用户下载工作空间下特定工作流WORKFLOW特定工作流实例的日志内容，需具有以下任一权限
- 查看工作流的权限: 查看
VIEW - 运行工作流的权限: 运行
EXECUTE - 编辑工作流的权限：编辑
MODIFY - 管理工作流的权限：管理
MANAGE
请求结构
Plain Text
1POST /api/databuilder/v2/workspaces/${workspaceId}/execution/${runId}/log/download/task HTTP/1.1
2Host: databuilder.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域
请求参数
| 参数名 | 类型 | 是否必填 | 参数位置 | 说明 |
|---|---|---|---|---|
| workspaceId | String | 是 | Path参数 | 工作空间ID，不允许为空或者只包含空白字符 |
| runId | String | 是 | Path参数 | 任务实例ID（对应工作流Id，集成任务对应运行id） |
| jobType | Enum | 是 | RequestBody | WORKFLOW、INTEGRATION |
| taskId | String | 是 | RequestBody | 工作流任务节点ID（当jobType = WORKFLOW时，必须传参） |
| logType | Enum | 否 | Request Body | 日志类型 RUN （运行日志）SUBMIT （应用提交日志） |
| moduleName | String | 否 | Request Body | 日志模块名称 |
| startDateTime | String | 否 | RequestBody | 查询开始时间（ISO8601，UTC），如：2025-01-10T13:23:34Z |
| endDateTime | String | 否 | RequestBody | 查询结束时间（ISO8601，UTC） |
| format | String | 否 | RequestBody | 下载文件格式，默认 json，支持：json,csv |
| limit | Integer | 否 | RequestBody | 最大下载行数，默认 1,000,000 |
| order | String | 否 | RequestBody | 排序方式，默认 desc（按时间倒序），支持 asc/desc |
| level | Enum | 否 | Request Body | 日志级别 TRACEDEBUGINFOWARNERROR默认是INFO |
| keywords | String | 否 | Request Body | 系统支持基于分词的关键词搜索，默认查询全部数据，并采用前缀匹配方式。支持多个关键词的前缀匹配组合搜索。关键词不支持特殊字符的搜索 （\t \n \r " # & ' ( ) , / : ; < = > ? @ [ \ ] { | }） |
响应头域
除公共头域外，无其它特殊头域
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 是否请求成功 |
| code | String | 返回码，成功一般为 OK 或业务码，失败为错误码 |
| message | String | 错误信息；成功时通常为空 |
| result | Result | 结果对象；仅成功时返回 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| AccessDenied | 无操作权限 | 403 | 暂无操作权限 |
请求示例
Plain Text
1POST https://databuilder.bd.baidubce.com/v2/workspaces/workspace_xxx/compute/compute_xxx/status HTTP/1.1
2Host: databuilder.bd.baidubce.com
3Authorization: authorization string
4{
5 "taskId": "tid-xx",
6 "jobType" : "WORKFLOW",
7 "logType" : "RUN",
8 "level": "INFO",
9 "startDateTime": "",
10 "endDateTime": "",
11 "limit": "100",
12 "order": "asc"
13 }响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3Transfer-Encoding: chunked
4Date: Mon, 28 Jul 2025 05:36:55 GMT
5Keep-Alive: timeout=180
6Connection: keep-alive
7{
8 "requestId":"xxxx-xxxx-xxxx-xxxx-yyyyyyyyyyy",
9 "code":"SUCCESS",
10 "result":{
11 "downloadId":"547f03eb-c262-25e4-cd1d-a9e9233e6f23"
12 }
13 }