调用该接口，会在新版数据开发中创建一个数据开发节点。
接口说明
注意 该接口不支持批量操作，若 FlowSpec 中定义了不止一个节点，则除第一个以外的后续节点均会被忽略。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| dataworks:CreateNode | create | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProjectId | long | 是 | DataWorks 工作空间的 ID。您可以登录 DataWorks 控制台，进入工作空间管理页面获取 ID。 该参数用来确定本次 API 调用操作使用的 DataWorks 工作空间。 | 123456 |
| ContainerId | long | 否 | 当你需要将节点创建在一个容器内部时，你需要指定这个参数。该参数为一个容器的唯一标识，这个容器可以是一个 Workflow 或者一个容器节点。 注意 该参数填写后，FlowSpec 中定义的 path 字段将无效 | 23451286945488XXXX |
| Scene | string | 是 | 节点创建的场景，决定节点创建在手动节点区域还是数据开发区域。DataworksManualWorkflow 只在填写了 ContainerId 且 Container 为手动工作流时才能使用。 可选值：
| DataworksProject |
| Spec | string | 是 | 描述这个 Node 的 FlowSpec 信息，具体规范详见 FlowSpec 。 | { "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "id":"860438872620113XXXX", "recurrence": "Normal", "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "datasource": { "name": "odps_test", "type": "odps" }, "script": { "path": "XX/OpenAPI测试/odpsSQL测试", "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测试", "inputs": { "nodeOutputs": [ { "data": "lwttest_standard_root", "artifactType": "NodeOutput" } ] }, "outputs": { "nodeOutputs": [ { "data": "output_data", "artifactType": "NodeOutput", "refTableName": "odpsSQL测试" } ] } } ], "flow": [ { "nodeId": "860438872620113XXXX", "depends": [ { "type": "Normal", "output": "project_root" } ] } ] } } |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "AFBB799F-8578-51C5-A766-E922EDB8XXXX",
"Id": 0
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-01-13 | API 内部配置变更，不影响调用 | 查看变更详情 |
| 2025-01-13 | OpenAPI 返回结构发生变更 | 查看变更详情 |