调用该接口，会在新版数据开发中创建一个数据开发节点。
接口说明
注意 该接口不支持批量操作，若 FlowSpec 中定义了不止一个节点，则除第一个以外的后续节点均会被忽略。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProjectId | long | 是 | DataWorks 工作空间的 ID。您可以登录 DataWorks 控制台，进入工作空间管理页面获取 ID。 该参数用来确定本次 API 调用操作使用的 DataWorks 工作空间。 | 123456 |
| ContainerId | long | 否 | 当你需要将节点创建在一个容器内部时，你需要指定这个参数。该参数为一个容器的唯一标识，这个容器可以是一个 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 |
| Spec | string | 是 | 描述这个节点的 FlowSpec 信息，具体规范详见 FlowSpec 。 说明
如何快速获取 FlowSpec 模板？
说明
节点的内容如何填写？
说明
离线同步节点的内容如何配置？
| { "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" } ] } } ] } } |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "AFBB799F-8578-51C5-A766-E922EDB8XXXX",
"Id": 0
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-01-13 | API 内部配置变更，不影响调用 | 查看变更详情 |
| 2025-01-13 | OpenAPI 返回结构发生变更 | 查看变更详情 |