全部产品
Search
文档中心

大数据开发治理平台 DataWorks:CreateNode - 创建数据开发节点

更新时间:Sep 03, 2026

调用该接口,会在新版数据开发中创建一个数据开发节点。

接口说明

重要 该接口不支持批量操作,若 FlowSpec 中定义了不止一个节点,则除第一个以外的后续节点均会被忽略。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

ProjectId

integer

是

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

该参数用来确定本次 API 调用操作使用的 DataWorks 工作空间。

123456

ContainerId

string

否

当你需要将节点创建在一个容器内部时,你需要指定这个参数。该参数为一个容器的唯一标识,这个容器可以是一个 Workflow 或者一个容器节点。

重要 该参数填写后,FlowSpec 中定义的 path 字段将无效
重要 该字段在 SDK8.0.0 版本之前为 Long 类型,SDK8.0.0 版本及之后为 String 类型。该变更不影响 SDK 正常使用,参数仍会按 SDK 中定义的类型返回。只有在跨 8.0.0 版本的 SDK 升级时,类型变更可能会导致项目编译不通过,需要用户手动修正数据类型。

23451286945488XXXX

Scene

string

是

节点创建的场景,决定节点创建在手动节点区域还是数据开发区域。DataworksManualWorkflow 只在填写了 ContainerId 且 Container 为手动工作流时才能使用。

可选值:

  • DATAWORKS_PROJECT 项目目录

  • DATAWORKS_MANUAL_WORKFLOW 手动工作流

  • DATAWORKS_MANUAL_TASK 手动任务

DATAWORKS_PROJECT

Spec

string

是

描述这个节点的 FlowSpec 信息,具体规范详见 FlowSpec 。

说明

如何快速获取 FlowSpec 模板?

  • 在数据开发中打开节点->点击右侧版本->查看最新版本->查看调度配置,即可得到针对当前节点的 FlowSpec 描述。可以基于版本中的 FlowSpec 描述快速构建符合要求的模板。

说明

节点的内容如何填写?

  • 节点的内容填写到$.spec.nodes[*].script.content 字段中。

说明

离线同步节点的内容如何配置?

  • 需要参考通过脚本模式配置离线同步任务中的步骤四编写脚本,并将内容填写到$.spec.nodes[*].script.content 字段中。或者在页面上创建一个离线同步节点,通过查看版本的方式获取离线同步节点的脚本内容。

{ "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "recurrence": "Normal", "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "datasource": { "name": "odps_test" }, "script": { "path": "XX/OpenAPI_Test/odpsSQL_Test", "runtime": { "command": "ODPS_SQL" }, "content": "select now();" }, "trigger": { "type": "Scheduler", "cron": "00 00 00 * * ?", "startTime": "1970-01-01 00:00:00", "endTime": "9999-01-01 00:00:00", "timezone": "Asia/Shanghai", "delaySeconds": 0 }, "runtimeResource": { "resourceGroup": "S_res_group_XXXX_XXXX" }, "name": "odpsSQL_Test", "inputs": { "nodeOutputs": [ { "data": "project_root", "artifactType": "NodeOutput" } ] }, "outputs": { "nodeOutputs": [ { "data": "output_data", "artifactType": "NodeOutput", "refTableName": "odpsSQL_Test" } ] } } ] } }

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

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

AFBB799F-8578-51C5-A766-E922EDB8XXXX

Id

string

数据开发节点的唯一标识符。

重要 该字段在 SDK8.0.0 版本之前为 Long 类型,SDK8.0.0 版本及之后为 String 类型。该变更不影响 SDK 正常使用,参数仍会按 SDK 中定义的类型返回。只有在跨 8.0.0 版本的 SDK 升级时,类型变更可能会导致项目编译不通过,需要用户手动修正数据类型。

860438872620113XXXX

示例

正常返回示例

JSON格式

{
  "RequestId": "AFBB799F-8578-51C5-A766-E922EDB8XXXX",
  "Id": "860438872620113XXXX"
}

错误码

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

变更历史

更多信息,参考变更详情。