全部產品
Search

搜尋本產品

    DataWorks：RunCycleDagNodes

    文件中心

    DataWorks：RunCycleDagNodes

    更新時間：Oct 09, 2026

    呼叫RunCycleDagNodes建立補資料工作流程。

    介面說明

    補資料相關內容，詳情請參見補資料。

    前置條件：呼叫本介面前需開通 DataWorks 企業版或旗艦版；未滿足版本要求時介面會返回 403 Forbidden.Access。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dataworks:*

    get

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ProjectEnv

    string

    是

    工作空間的環境，PROD 表示生產環境，DEV 表示開發環境。

    枚舉值：

    • PROD :

      生產環境。

    • DEV :

      開發環境。

    PROD
    StartBizDate

    string

    是

    補資料的起始業務日期。格式為 yyyy-MM-dd 00:00:00。

    2020-05-20 00:00:00
    Name

    string

    是

    工作流程的名稱。

    xm_test
    RootNodeId

    integer

    是

    補資料的起始節點 ID。您可以透過呼叫 ListNodes 介面取得節點 ID。

    1234
    ExcludeNodeIds

    string

    否

    無需補資料的節點 ID 清單，在這個清單中的節點會產生空跑執行個體，空跑執行個體被排程後會直接執行成功，不會執行指令碼內容。

    1234,123465
    BizBeginTime

    string

    否

    任務的開始時間。僅小時排程任務需要設定該參數，格式為 HH:mm:ss，取值範圍為 00:00:00~23:59:59。

    00:00:00
    BizEndTime

    string

    否

    任務的結束時間。僅小時排程任務需要設定該參數，格式為 HH:mm:ss，取值範圍為 00:00:00~23:59:59。

    01:00:00
    Parallelism

    boolean

    是

    多個業務日期的任務是否可以並行執行。

    false
    EndBizDate

    string

    是

    補資料的結束業務日期。格式為 yyyy-MM-dd 00:00:00。

    2020-05-21 00:00:00
    NodeParams

    string

    否

    設定為一個 JSON 字串，Key 為節點 ID，Value 為參數的實際取值。

    {"74324":"a=123 b=456"}
    IncludeNodeIds

    string

    是

    補資料的節點 ID。對多個節點補資料時，多個節點 ID 使用逗號（,）分隔。您可以透過呼叫 ListNodes 介面取得節點 ID。

    74324,74325
    StartFutureInstanceImmediately

    boolean

    否

    是否立刻執行未來排程時間的執行個體，如果設定為 true，則大於目前時間的執行個體會立刻執行，否則會等待排程時間。

    false
    ConcurrentRuns

    integer

    否

    任務並行數。取值範圍 2~10。

    5
    AlertType

    string

    否

    警示類型。取值範圍：

    • SUCCESS：成功警示。

    • FAILURE：失敗警示。

    • SUCCESS_FAILURE：成功或失敗皆警示。

    枚舉值：

    • SUCCESS :

      成功警示。

    • SUCCESS_FAILURE :

      成功或失敗皆警示。

    • FAILURE :

      失敗警示。

    FAILURE
    AlertNoticeType

    string

    否

    警示通知方式。取值範圍：

    • SMS：簡訊。

    • MAIL：郵件。

    • SMS_MAIL：簡訊與郵件。

    枚舉值：

    • MAIL :

      郵件。

    • SMS :

      簡訊。

    • SMS_MAIL :

      簡訊與郵件。

    SMS

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回實體。

    HttpStatusCode

    integer

    HTTP 狀態碼。

    200
    RequestId

    string

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

    >E6F0DBDD-5AD****
    ErrorMessage

    string

    錯誤資訊。

    The connection does not exist.
    Success

    boolean

    呼叫是否成功。

    true
    ErrorCode

    string

    錯誤碼。

    Invalid.Tenant.ConnectionNotExists
    Data

    array

    週期任務補資料返回的 DagId，可以透過該 DagId 查到對應的執行個體。

    integer

    工作流程 ID 的清單。

    111

    樣本

    正常返回樣本

    JSON格式

    {
  "HttpStatusCode": 200,
  "RequestId": ">E6F0DBDD-5AD****",
  "ErrorMessage": "The connection does not exist.",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Data": [
    111
  ]
}

    錯誤碼

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

    變更歷史

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