文档首页> 数据治理中心 DataArts Studio> API参考（吉隆坡区域）> 数据开发API> 待下线API> 导入作业
更新时间：2023-06-15 GMT+08:00
查看PDF

导入作业

功能介绍

将存放在OBS桶的作业文件导入到DLF，一次可以导入一个或多个作业。

执行本接口之前，需要将作业文件放到OBS的桶中。

URI

  • URI格式

    POST /v1/{project_id}/jobs/import

  • 参数说明
    表1 URI参数说明

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

    项目编号，获取方法请参见项目ID和帐号ID。

请求消息

表2 参数说明

参数名

是否必选

参数类型

说明

path

是

String

有OBS场景：作业定义文件在OBS上的路径，作业定义文件的格式参考导出作业的响应消息。例如obs://myBucket/jobs.zip

params

否

Map<String,String>

公共作业参数

sameNamePolicy

否

String

重名策略

  • SKIP ：跳过
  • OVERWRITE ：覆盖

默认值是SKIP

jobsParam

否

List<JobParam>

指定作业参数，参考表3

executeUser

否

String

执行作业的用户
表3 JobParam属性说明

参数名

是否必选

参数类型

说明

name

是

String

作业名称

params

否

Map<String,String>

作业参数

响应参数

表4 参数说明

参数名

是否必选

参数类型

说明

taskId

是

String

任务ID，请调用查询系统任务接口获取导入状态。

示例

从OBS路径上导入作业，如果有重名作业、脚本，则覆盖。

  • 请求
    POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/import
{
"path": "obs://aaaaa/job_batch.zip",
"sameNamePolicy": "OVERWRITE",
"jobsParam": [{
"name": "job_batch",
"params": {
"streamName": "dis-AHTr"
}
}]
}
  • 成功响应
    HTTP状态码 200 
    {
"taskId":"008aae2e675933c7016759418e870000"
}
  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.0815",
    "error_msg":"Fail to read OBS file."
}
父主题： 待下线API