全部產品
Search
文件中心

:ListClusters - 列出叢集資訊

更新時間:Mar 21, 2026

列出註冊到 DataWorks 的叢集資訊,目前支援 EMR 叢集、CDH 叢集。

介面說明

本介面當前處於試用階段。需要體驗的使用者可以提出申請,管理員加入試用名單後即可調用。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

ClusterType

string

叢集類型,支援的叢集類型如下:

  • CDH(CDH 叢集)

  • EMR(EMR 叢集)

EMR

PageNumber

integer

頁碼,大於等於 1 的正整數,預設為 1。

1

PageSize

integer

每頁記錄數,預設為 10 條,最大 100 條。

10

返回參數

名稱

類型

描述

樣本值

object

返回結構。

Data

object

返回資料。

PageNumber

integer

頁碼。

1

PageSize

integer

每頁記錄數。

10

TotalCount

integer

總記錄數。

100

Clusters

array

叢集資訊列表。

Cluster

叢集資訊。

RequestId

string

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

0000-ABCD-E****

Success

boolean

請求是否成功:

  • true(成功)

  • false(失敗)

true

ErrorCode

string

錯誤碼。

101011005

ErrorMessage

string

錯誤資訊。

Invalid.Cluster.ClusterNotFound

HttpStatusCode

integer

HTTP 狀態代碼。

200

樣本

正常返回樣本

JSON格式

{
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "Clusters": [
      {
        "ClusterId": 1234,
        "ClusterBizId": "c-d8a7523****"
      }
    ]
  },
  "RequestId": "0000-ABCD-E****",
  "Success": true,
  "ErrorCode": "101011005",
  "ErrorMessage": "Invalid.Cluster.ClusterNotFound",
  "HttpStatusCode": 200
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情