# 导出作业 - ExportJob
#### 功能介绍
导出zip压缩包格式的作业文件，包括作业定义、作业依赖的脚本、CDM作业定义。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DGC/doc?api=ExportJob)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
- URI格式 POST /v1/{project_id}/jobs/{job_name}/export
  

- 参数说明
  表1URI参数说明 
  | 参数名        | 是否必选 | 参数类型   | 说明                                                                                                    |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。 |
  | job_name   | 是    | String | 作业名称。                                                                                                 |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数名       | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| workspace | 否    | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。  - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。  - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。      |
   
表3请求参数说明 
| 参数名          | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| exportDepend | 否    | boolean | 是否导出作业依赖的脚本和资源，取值为true或者false。 默认值：true                                                                                                                                                                                                                                                     |
| obsPath      | 否    | String  | 导出作业的OBS目标地址 - 如果不设置该参数，默认导出作业文件流数据到本地。  - 如果需要将作业导出到OBS，需要带上该参数，样例：obs://test_bucket/job_nodes/   |
| exportStatus | 否    | String  | 导出作业的状态，取值如下: - DEVELOP：开发态，默认是开发态  - SUBMIT：提交态                                                          |
   
 #### 响应参数
响应消息的Content-Type是application/octet-stream，需要解析转化为一个文件，可以参考[解析响应消息体中的流样例代码](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0317.html)。响应是一个压缩文件，文件名称格式DLF_{job_name}.zip，压缩文件里面的文件目录如下：
```
jobs
├─{job_name}.job
scripts
├─{script_name}.script
resources
├─{resource_name}.resource
```
上述文件名中的参数说明如[表4]所示。
 表4参数说明 
| 参数名           | 是否必选 | 参数类型   | 说明          |
|:---|:---|:---|:---|
| job_name      | 是    | String | 作业名称        |
| script_name   | 否    | String | 作业所依赖的脚本名称。 |
| resource_name | 否    | String | 作业所依赖的资源名称。 |
   
- {job_name}.job文件内容 文件中的参数与创建作业接口的请求参数一样，请参考[创建作业 - CreateJob](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0084.html)。
  
- {script_name}.script文件内容 文件中的参数与创建资源接口的请求参数一样，请参考[创建脚本 - CreateScript](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0097.html)。
  
 
#### 请求示例
导出作业myJob。
```
POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/myJob/export
{
    "obsPath": "obs://000dpstestdata/job_nodes/",
    "exportDepend": true,
    "exportStatus": "SUBMIT"
}
```
#### 响应示例
- 成功响应 HTTP状态码 200
  导出文件名为DLF_myJob.zip，解压后文件结构如下：
  ```
  jobs
  ├─myJob.job
  scripts
  ├─CS_PROCESS_TRIP.script
  ├─TRIP_RAW_STANDARD.script
  ```
  
- 失败响应 HTTP状态码 400
  ```
  {
      "error_code":"DLF.30100",
      "error_msg":"The job does not exists."
  }
  ```