使用CreateNode API建立資料開發節點-巨量資料開發治理平台 DataWorks-阿里雲

介面說明

重要該介面不支援大量操作，若 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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。