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

接口说明

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

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
ProjectId	long	是	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"
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2025-12-29	OpenAPI 返回结构发生变更	查看变更详情
2025-01-13	API 内部配置变更，不影响调用	查看变更详情
2025-01-13	OpenAPI 返回结构发生变更	查看变更详情