全部產品
Search
文件中心

Data Management:ListTasksInTaskFlow - 擷取指定任務流的任務節點列表

更新時間:Mar 21, 2026

調用ListTasksInTaskFlow介面,擷取指定任務流的任務節點列表。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dms:ListTasksInTaskFlow

list

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Tid

integer

租戶 ID。

說明

滑鼠移動到介面右上方的頭像處,查看租戶 ID。具體操作,請參見查看租戶資訊

3***

DagId

integer

任務流 ID,可通過調用介面 ListTaskFlowListLhTaskFlowAndScenario 擷取該參數的值。

32***

返回參數

名稱

類型

描述

樣本值

object

返回參數詳情如下。

RequestId

string

請求 ID,用於定位日誌,排查問題。

8B36B063-6B7D-5595-9FCF-3844B7B7ACD4

ErrorCode

string

錯誤碼。

UnknownError

ErrorMessage

string

調用失敗時,返回的錯誤資訊。

任務流不存在或沒有許可權

Success

boolean

請求是否成功,傳回值如下:

  • true:請求成功

  • false:請求失敗

true

Tasks

object

Task

array<object>

工作清單。

object

工作清單詳情如下。

NodeName

string

節點名稱。

Cross-Database Spark SQL-1

NodeType

string

任務節點類型,傳回值請參見 NodeType 參數說明

SPARK_SQL

NodeContent

string

節點配置內容。

{ "dbId":123456, // 資料庫Id "sql":"/* 請使用當前節點所選擇的資料庫文法編寫SQL */", // sql語句 "dbType":"polardb" // 資料庫類型 }

TimeVariables

string

節點變數(時間變數配置)。

{ "variables":[ // "variables"為固定值 { "name":"var", // name指定變數名 "pattern":"yyyy-MM-dd|+0m+0h-2d+0w+0M+1y" // 見後面解釋 } ] }

NodeConfig

string

節點進階配置。

{ "rerun":{ // 必填固定值 "rerunEnable":true, // 是否開啟重跑 "rerunCount":1, // 重跑次數 "rerunInterval":10 // 重跑間隔 } }

NodeOutput

string

任務輸出變數。

{ "outputs":[ { /* 變數提取設定 { "row":0, // 行,-1為所有行 "column":-1, // 列,-1為所有列 /* 分隔字元 當選中所有行或所有列時,需要指定串連符。變數傳回值為字串 */ "combiner":"," } */ "extractMethod":"{\"row\":0,\"column\":-1,\"combiner\":\",\"}", "variableName":"var", // 變數名 "description":"For demo" // 變數介紹 } ] }

GraphParam

string

節點在圖上的顯示位置。

{\"x\":435,\"y\":192,\"layoutType\":\"Horizontal\"}

NodeId

string

節點 ID。

92***

樣本

正常返回樣本

JSON格式

{
  "RequestId": "8B36B063-6B7D-5595-9FCF-3844B7B7ACD4",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "任務流不存在或沒有許可權",
  "Success": true,
  "Tasks": {
    "Task": [
      {
        "NodeName": "Cross-Database Spark SQL-1",
        "NodeType": "SPARK_SQL",
        "NodeContent": "{     \"dbId\":123456, // 資料庫Id     \"sql\":\"/* 請使用當前節點所選擇的資料庫文法編寫SQL */\", // sql語句     \"dbType\":\"polardb\" // 資料庫類型 }",
        "TimeVariables": "{   \"variables\":[     // \"variables\"為固定值     {       \"name\":\"var\", // name指定變數名       \"pattern\":\"yyyy-MM-dd|+0m+0h-2d+0w+0M+1y\" // 見後面解釋     }   ] }",
        "NodeConfig": "{     \"rerun\":{ // 必填固定值         \"rerunEnable\":true, // 是否開啟重跑         \"rerunCount\":1, // 重跑次數         \"rerunInterval\":10 // 重跑間隔     } }",
        "NodeOutput": "{     \"outputs\":[         {             /*             變數提取設定             {                 \"row\":0, // 行,-1為所有行                 \"column\":-1, // 列,-1為所有列                 /*                 分隔字元                 當選中所有行或所有列時,需要指定串連符。變數傳回值為字串                 */                 \"combiner\":\",\"              }             */             \"extractMethod\":\"{\\\"row\\\":0,\\\"column\\\":-1,\\\"combiner\\\":\\\",\\\"}\",              \"variableName\":\"var\", // 變數名             \"description\":\"For demo\" // 變數介紹         }     ] }",
        "GraphParam": "{\\\"x\\\":435,\\\"y\\\":192,\\\"layoutType\\\":\\\"Horizontal\\\"}",
        "NodeId": "92***"
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情