全部產品
Search
文件中心

DataWorks:ListNodes - 擷取節點的列表

更新時間:Mar 21, 2026

調用ListNodes擷取節點的列表。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:*

list

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Owner

string

負責人的 ID。

193379****

BizName

string

商務程序的名稱。

test_bizName

ProgramType

string

節點的類型。您可以調用 ListFileType 查看節點類型。

ODPS_SQL

PageNumber

integer

頁碼數。最小值 1,最大值 100

1

PageSize

integer

每頁顯示的條數,預設為 10 條,最大 100 條。

10

ProjectId

integer

工作空間的 ID。

1234

ProjectEnv

string

啟動並執行環境,包括 DEV 和 PROD。

PROD

NodeName

string

節點的名稱。

liux_test_n****

SchedulerType

string

調度的類型,取值如下:

  • NORMAL:正常調度任務。

  • PAUSE:暫停任務。

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

NORMAL

返回參數

名稱

類型

描述

樣本值

object

返回實體。

HttpStatusCode

integer

HTTP 狀態代碼。

200

RequestId

string

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

E6F0DBDD-5AD****

ErrorMessage

string

錯誤資訊。

The connection does not exist.

ErrorCode

string

錯誤碼。

Invalid.Tenant.ConnectionNotExists

Success

boolean

調用是否成功。

true

Data

object

節點的列表。

PageNumber

integer

頁碼數。

1

PageSize

integer

每頁顯示的條數,預設為 10 條,最大 100 條。

10

TotalCount

integer

合格節點總數。

66

Nodes

array<object>

節點的資訊。

object

返回實體。

SchedulerType

string

調度的類型,取值如下:

  • NORMAL:正常調度任務。

  • PAUSE:暫停任務。

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

NORMAL

RepeatInterval

integer

出錯後重新調度頻率。

60

Repeatability

boolean

是否可以重複運行。

true

RepeatMode

integer

重跑的模式,0 表示只有失敗的情況下可以重跑,1 表示所有情況均可重跑,2 表示所有情況下均不可重跑。

1

ProjectId

integer

工作空間的 ID。

33671

ProgramType

string

節點的類型。

ODPS_SQL

Priority

integer

優先順序,1/3/5/7/8

1

OwnerId

string

負責人的 ID。

19337906836551

Connection

string

串連串。

odps_source

ParamValues

string

額外的參數。

a=b

RelatedFlowId

integer

關聯商務程序 ID。

1231123

DqcType

integer

DQC 類型,0 表示沒有關聯 dqc,1 表示有關聯 dqc。

1

BaselineId

integer

基準 ID。

123456

Description

string

節點的描述資訊。

test

NodeName

string

節點的名稱。

liux_test_n****

ResGroupName

string

資源群組的名稱。

預設資源群組

BusinessId

integer

商務程序 ID。

123

DqcDescription

string

DQC 分區規則串。

[{"projectName":"ztjy_dim","tableName":"dim_user_agent_manage_area_a","partition":"ds\u003d$[yyyy-mm-dd-1]"}]

CronExpress

string

cron 運算式。

00 00 00 * * ?

NodeId

integer

節點的 ID。

1234

ResGroupIdentifier

string

資源群組標識。

group_123

FileType

integer

不同檔案類型其代碼不同,詳情請參見 DataWorks 節點合集。 您也可以調用 ListFileType 介面,查詢檔案的代碼類型。

10

FileId

integer

檔案的 ID。您可以調用 ListFiles 介面查詢對應檔案的 ID。

警告 欄位已棄用

20

FileVersion

integer

檔案的版本。為當前已經提交的最新版本號碼。

3

DeployDate

integer

提交發布日期的時間戳記,單位為毫秒。

1734537600000

CreateTime

integer

節點建立的時間戳記,單位為毫秒。

1593879116000

ModifyTime

integer

節點修改的時間戳記,單位為毫秒。

1593879116000

樣本

正常返回樣本

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "E6F0DBDD-5AD****",
  "ErrorMessage": "The connection does not exist.",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 66,
    "Nodes": [
      {
        "SchedulerType": "NORMAL",
        "RepeatInterval": 60,
        "Repeatability": true,
        "RepeatMode": 1,
        "ProjectId": 33671,
        "ProgramType": "ODPS_SQL",
        "Priority": 1,
        "OwnerId": "19337906836551",
        "Connection": "odps_source",
        "ParamValues": "a=b",
        "RelatedFlowId": 1231123,
        "DqcType": 1,
        "BaselineId": 123456,
        "Description": "test",
        "NodeName": "liux_test_n****",
        "ResGroupName": "預設資源群組",
        "BusinessId": 123,
        "DqcDescription": "[{\"projectName\":\"ztjy_dim\",\"tableName\":\"dim_user_agent_manage_area_a\",\"partition\":\"ds\\u003d$[yyyy-mm-dd-1]\"}]",
        "CronExpress": "00 00 00 * * ?",
        "NodeId": 1234,
        "ResGroupIdentifier": "group_123",
        "FileType": 10,
        "FileId": 20,
        "FileVersion": 3,
        "DeployDate": 1734537600000,
        "CreateTime": 1593879116000,
        "ModifyTime": 1593879116000
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情