全部產品
Search
文件中心

DataWorks:ListManualDagInstances - 擷取手動執行的協調流程執行個體的資訊

更新時間:Mar 21, 2026

擷取手動執行的協調流程執行個體的資訊。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:*

list

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

ProjectEnv

string

營運中心的調度環境標識,包括 PROD(生產環境)和 DEV(開發環境)。

RPOD

ProjectName

string

手動商務程序所屬的工作空間名稱。您可以進入 DataWorks 控制台,在工作空間配置頁面擷取。

test_workspace

DagId

string

觸發手動商務程序啟動並執行 Dag 執行個體 ID。您可以調用 RunManualDagNodes 介面擷取。

7000001231241

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

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

SDFSDFSDF-SDFSDF-SDFDSF-SDFSDF

Instances

array<object>

手動商務程序的內部執行個體列表。

object

返回資料。

Status

string

執行個體任務的狀態,取值如下:

  • NOT_RUN(未運行)

  • WAIT_TIME(等待定時時間 DueTime 或 CycleTime 到來)

  • WAIT_RESOURCE(等待資源)

  • RUNNING(運行中)

  • CHECKING(下發給資料品質進行資料校檢)

  • CHECKING_CONDITION(進行中分支條件校檢)

  • FAILURE(執行失敗)

  • SUCCESS(執行成功)

SUCCESS

BeginRunningTime

integer

執行個體任務開始啟動並執行時間。

1605178414676

BizDate

integer

業務日期。通常為該任務已耗用時間的前一天。

1605178414676

CycTime

integer

執行個體任務的定時時間。

1605178414676

FinishTime

integer

執行個體任務啟動並執行結束時間。

1605178414676

CreateTime

integer

執行個體任務的建立時間。

1605178414676

DagId

integer

手動協調流程執行個體的 DagId。

350850491

InstanceId

integer

內部執行個體 ID。

11726873619

BeginWaitResTime

integer

執行個體任務開始等待資源的時間。

1605178414676

TaskType

string

執行個體任務的調度類型,取值如下:

  • NORMAL(0):正常調度任務。該任務被日常調度。

  • MANUAL(1):手動任務。該任務不會被日常調度。

  • PAUSE(2):凍結任務。該任務被日常調度,但啟動調度時直接被置為失敗狀態。

  • SKIP(3):空跑任務。該任務被日常調度,但啟動調度時直接被置為成功狀態。

  • SKIP_UNCHOOSE(4):臨時工作流程中未選擇的任務,僅存在於臨時工作流程中,啟動調度時直接被置為成功狀態。

  • SKIP_CYCLE(5):未到運行周期的周或月任務。該任務被日常調度,但啟動調度時直接被置為成功狀態。

  • CONDITION_UNCHOOSE(6):上遊執行個體中有分支(IF)節點,但是該下遊節點未被分支節點選中,直接置為空白跑任務。

  • REALTIME_DEPRECATED(7):即時產生的已經到期的周期執行個體,該類型的任務直接被置為成功狀態。

MANUAL

ParamValues

string

執行個體的參數資訊。

xxx=yyy

DagType

string

手動商務程序的標識。

5

NodeName

string

節點的名稱。

test2

BeginWaitTimeTime

integer

執行個體任務開始等待調度的時間。

1605178414676

NodeId

integer

商務程序的內部節點 ID。

37851

ModifyTime

integer

最近一次修改執行個體任務的時間。

1605178414676

CreateUser

string

觸發執行個體啟動並執行使用者。例如,使用者 Test 觸發運行手動執行的協調流程執行個體,則 CreateUser 為 Test。

Test

樣本

正常返回樣本

JSON格式

{
  "RequestId": "SDFSDFSDF-SDFSDF-SDFDSF-SDFSDF",
  "Instances": [
    {
      "Status": "SUCCESS",
      "BeginRunningTime": 1605178414676,
      "BizDate": 1605178414676,
      "CycTime": 1605178414676,
      "FinishTime": 1605178414676,
      "CreateTime": 1605178414676,
      "DagId": 350850491,
      "InstanceId": 11726873619,
      "BeginWaitResTime": 1605178414676,
      "TaskType": "MANUAL",
      "ParamValues": "xxx=yyy",
      "DagType": "5",
      "NodeName": "test2",
      "BeginWaitTimeTime": 1605178414676,
      "NodeId": 37851,
      "ModifyTime": 1605178414676,
      "CreateUser": "Test"
    }
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情