全部產品
Search
文件中心

DataWorks:GetWorkflowDefinition - 擷取資料開發工作流程詳情

更新時間:Mar 21, 2026

調用該介面,可以擷取指定工作流程的詳細資料。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:*

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

ProjectId

integer

DataWorks 工作空間的 ID。您可以登入 DataWorks 控制台,進入工作空間管理頁面擷取 ID。

該參數用來確定本次 API 呼叫操作使用的 DataWorks 工作空間。

10000

Id

string

資料開發工作流程唯一識別碼。

重要 該欄位在 SDK8.0.0 版本之前為 Long 類型,SDK8.0.0 版本及之後為 String 類型。該變更不影響 SDK 正常使用,參數仍會按 SDK 中定義的類型返回。只有在跨 8.0.0 版本的 SDK 升級時,類型變更可能會導致專案編譯不通過,需要使用者手動修正資料類型。

860438872620****

IncludeScriptContent

boolean

查詢結果是否包含工作流程內部節點的指令碼內容(對於內容較多的節點,可能存在較長的網路傳輸延時)。

false

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

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

F2BDD628-8A21-5BD1-B930-1A2D5989XXXX

WorkflowDefinition

object

資料開發工作流程的詳細資料

ProjectId

integer

資料開發工作流程所在工作空間的 ID。

307XXX

Name

string

資料開發工作流程名稱

OpenAPI test workflow Demo

Owner

string

資料開發工作流程的責任人

110755000425XXXX

CreateTime

integer

資料開發工作流程的建立時間戳記

1708481905000

ModifyTime

integer

資料開發工作流程的最新動向時間戳記

1708481905000

Spec

string

描述這個工作流程的 FlowSpec 資訊,具體規範詳見 FlowSpec

{ "metadata": { "tenantId": "52425742456XXXX", "projectId": "307XXXX", "uuid": "463497880880954XXXX" }, "kind": "CycleWorkflow", "version": "1.1.0", "spec": { "name": "OpenAPI_Test_Workflow_Demo", "id": "463497880880954XXXX", "type": "CycleWorkflow", "owner": "110755000425XXXX", "workflows": [ { "script": { "path": "XX/OpenAPI_Test/Workflow_Test/OpenAPI_Test_Workflow_Demo", "runtime": { "command": "WORKFLOW" }, "id": "698002781368644XXXX" }, "id": "463497880880954XXXX", "trigger": { "type": "Scheduler", "id": "652567824470354XXXX", "cron": "00 02 00 * * ?", "startTime": "1970-01-01 00:00:00", "endTime": "9999-01-01 00:00:00", "timezone": "Asia/Shanghai", "delaySeconds": 0 }, "strategy": { "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "failureStrategy": "Break" }, "name": "OpenAPI_Test_Workflow_Demo", "owner": "110755000425XXXX", "metadata": { "owner": "110755000425XXXX", "ownerName": "XXXX@test.XXXX.com", "tenantId": "52425742456XXXX", "project": { "mode": "STANDARD", "projectId": "307303", "projectIdentifier": "lwttest_standard", "projectName": "XXXX", "projectOwnerId": "110755000425XXXX", "simple": false, "tenantId": "52425742456XXXX" }, "projectId": "307XXXX" }, "inputs": {}, "outputs": { "nodeOutputs": [ { "data": "463497880880954XXXX", "artifactType": "NodeOutput", "refTableName": "OpenAPI_Test_Workflow_Demo", "isDefault": true } ] }, "nodes": [], "dependencies": [] } ] } }

WorkflowId

integer

發布後在調度側的工作流程 ID

700006657495

Id

string

資料開發工作流程唯一識別碼。

重要 該欄位在 SDK8.0.0 版本之前為 Long 類型,SDK8.0.0 版本及之後為 String 類型。該變更不影響 SDK 正常使用,參數仍會按 SDK 中定義的類型返回。只有在跨 8.0.0 版本的 SDK 升級時,類型變更可能會導致專案編譯不通過,需要使用者手動修正資料類型。

463497880880954XXXX

樣本

正常返回樣本

JSON格式

{
  "RequestId": "F2BDD628-8A21-5BD1-B930-1A2D5989XXXX",
  "WorkflowDefinition": {
    "ProjectId": 0,
    "Name": "OpenAPI test workflow Demo",
    "Owner": "110755000425XXXX",
    "CreateTime": 1708481905000,
    "ModifyTime": 1708481905000,
    "Spec": "{\n    \"metadata\": {\n        \"tenantId\": \"52425742456XXXX\",\n        \"projectId\": \"307XXXX\",\n        \"uuid\": \"463497880880954XXXX\"\n    },\n    \"kind\": \"CycleWorkflow\",\n    \"version\": \"1.1.0\",\n    \"spec\": {\n        \"name\": \"OpenAPI_Test_Workflow_Demo\",\n        \"id\": \"463497880880954XXXX\",\n        \"type\": \"CycleWorkflow\",\n        \"owner\": \"110755000425XXXX\",\n        \"workflows\": [\n            {\n                \"script\": {\n                    \"path\": \"XX/OpenAPI_Test/Workflow_Test/OpenAPI_Test_Workflow_Demo\",\n                    \"runtime\": {\n                        \"command\": \"WORKFLOW\"\n                    },\n                    \"id\": \"698002781368644XXXX\"\n                },\n                \"id\": \"463497880880954XXXX\",\n                \"trigger\": {\n                    \"type\": \"Scheduler\",\n                    \"id\": \"652567824470354XXXX\",\n                    \"cron\": \"00 02 00 * * ?\",\n                    \"startTime\": \"1970-01-01 00:00:00\",\n                    \"endTime\": \"9999-01-01 00:00:00\",\n                    \"timezone\": \"Asia/Shanghai\",\n                    \"delaySeconds\": 0\n                },\n                \"strategy\": {\n                    \"timeout\": 0,\n                    \"instanceMode\": \"T+1\",\n                    \"rerunMode\": \"Allowed\",\n                    \"rerunTimes\": 3,\n                    \"rerunInterval\": 180000,\n                    \"failureStrategy\": \"Break\"\n                },\n                \"name\": \"OpenAPI_Test_Workflow_Demo\",\n                \"owner\": \"110755000425XXXX\",\n                \"metadata\": {\n                    \"owner\": \"110755000425XXXX\",\n                    \"ownerName\": \"XXXX@test.XXXX.com\",\n                    \"tenantId\": \"52425742456XXXX\",\n                    \"project\": {\n                        \"mode\": \"STANDARD\",\n                        \"projectId\": \"307303\",\n                        \"projectIdentifier\": \"lwttest_standard\",\n                        \"projectName\": \"XXXX\",\n                        \"projectOwnerId\": \"110755000425XXXX\",\n                        \"simple\": false,\n                        \"tenantId\": \"52425742456XXXX\"\n                    },\n                    \"projectId\": \"307XXXX\"\n                },\n                \"inputs\": {},\n                \"outputs\": {\n                    \"nodeOutputs\": [\n                        {\n                            \"data\": \"463497880880954XXXX\",\n                            \"artifactType\": \"NodeOutput\",\n                            \"refTableName\": \"OpenAPI_Test_Workflow_Demo\",\n                            \"isDefault\": true\n                        }\n                    ]\n                },\n                \"nodes\": [],\n                \"dependencies\": []\n            }\n        ]\n    }\n}",
    "WorkflowId": 700006657495,
    "Id": "463497880880954XXXX"
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情