调用CreateExportMigration,新建一个DataWorks的导出任务。该API仅创建导出任务,不会启动执行导出任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateExportMigration

要执行的操作。

RegionId String cn-shanghai

地域信息,通常是服务所在的地域。例如,华东2(上海)是cn-shanghai,华北3(张家口)是cn-zhangjiakou。您无需填写RegionId,会根据调用的Endpoint自动解析。

ProjectId Long 12345

DataWorks工作空间的ID。您可以登录DataWorks控制台,进入工作空间配置页面获取工作空间ID。

Name String test_export_01

导出任务的名称。

名称必须唯一,即当前DataWorks工作空间中不能存在名称重复的导出任务。

ExportMode String FULL

任务的导出模式,取值如下:

  • FULL:全量导出目标任务。
  • INCREMENTAL:从指定的时间点开始,增量导出目标任务。选择该模式时,需要同时配置IncrementalSince参数。
IncrementalSince Long 1589904000000

增量导出目标任务的起始时间。

当ExportMode参数配置为INCREMENTAL时,IncrementalSince参数才生效。

ExportObjectStatus String SAVED

导出任务的状态。系统会根据所选状态导出指定状态的任务。取值如下:

  • SAVED:保存状态,即导出已保存的任务。
  • SUBMITTED:提交状态,即导出已提交的任务。
  • DEPLOYED:发布状态,即导出已发布的任务。
Description String test

导出任务的描述信息。

返回数据

名称 类型 示例值 描述
RequestId String 34267E2E-0335-1A60-A1F0-ADA530890CBA

请求ID。用于定位日志,排查问题。

Data Long 1234

导出任务的ID。

Success Boolean true

调用是否成功。取值如下:

  • true:调用成功。
  • false:调用失败,您可以根据请求ID定位具体问题。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateExportMigration
&ProjectId=12345
&Name=test_export_01
&ExportMode=FULL
&IncrementalSince=1589904000000
&ExportObjectStatus=SAVED
&Description=test
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateExportMigrationResponse>
    <RequestId>34267E2E-0335-1A60-A1F0-ADA530890CBA</RequestId>
    <Data>1234</Data>
    <Success>true</Success>
</CreateExportMigrationResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "34267E2E-0335-1A60-A1F0-ADA530890CBA",
  "Data" : 1234,
  "Success" : true
}

错误码

访问错误中心查看更多错误码。