全部產品
Search
文件中心

DataWorks:ListComputeResources - 擷取計算資源清單

更新時間:Mar 21, 2026

根據計算資源商務資訊,查詢符合的計算資源清單。

介面說明

  1. 需要購買 DataWorks 基礎版及以上版本才能使用。

  2. 需要在 DataWorks 專案空間中具有如下至少一種角色:

  3. 租戶所有者、空間管理員、部署、開發、訪客、專案所有者、營運、模型設計師、安全性系統管理員、資料分析師、開發平台管理員、資料治理管理員

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:ListComputeResources

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

ProjectId

integer

DataWorks 工作空間的 ID。

21229

Name

string

計算資源的名稱。

category name

Types

array

計算資源類型查詢過濾,可以配置多個類型查詢過濾。

string

計算資源的類型。

hologres

EnvType

string

計算資源環境類型,枚舉值:

  • Dev:開發環境

  • Prod:生產環境

Dev

PageNumber

integer

查詢第幾頁,預設值為 1 表示第一頁。

1

PageSize

integer

分頁大小,預設值為 10,最大值 100。

10

SortBy

string

計算資源清單排序欄位,支援名稱、建立時間、計算資源 ID 排序

  • CreateTime:建立時間

  • Id:計算資源 ID

  • Name:計算資源名稱

  • CreateTimeWithDefaultFirst:基於預設與否和建立時間排序,預設計算資源排序在前

預設值:CreateTime

CreateTimeWithDefaultFirst

Order

string

計算資源清單排序方向,枚舉值:

  • Desc:倒序

  • Asc:正序

預設值:Desc

Asc

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

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

7C352CB7-CD88-50CF-9D0D-E81BDF02XXXX

PagingInfo

object

分頁資訊。

TotalCount

integer

總條數。

100

PageSize

integer

頁大小。

10

PageNumber

integer

頁碼。

1

ComputeResources

array<object>

計算資源清單,每一個元素是一個計算資源群組,包含開發環境(如有)和生產環境的資訊。

array<object>

計算資源群組資訊,包含開發環境(如有)和生產環境的計算資源。開發環境和生產環境的計算資源具有相同的計算資源名稱和計算資源類型,不相同的計算資源 ID。

Name

string

計算資源的名稱。

cal_all_vemg_workflow_parallel

Type

string

計算資源類型。

hologres

ComputeResource

array<object>

單條計算資源資訊。

object

單條計算資源資訊。

Id

integer

計算資源 ID,計算資源的唯一識別碼。

8649832502405358603

ConnectionProperties

any

計算資源添加的類別,不同 type 下會有不同的子類型,對應有不同的參數約束,情境舉例: InstanceMode 執行個體模式。 UrlMode 串連串模式。

{\n \"clusterIdentifier\": \"c-da123456\",\n \"database\": \"testdb\",\n \"loginMode\":\"Anonymous\",\n \"defaultFS\":\"127.0.0.1\",\n \"envType\": \"Prod\"\n}

ConnectionPropertiesMode

string

計算資源的具體串連配置資訊,包括串連地址、訪問身份、環境資訊等。計算資源環境 envType 資訊是此對象的成員屬性,包括

  • Dev(開發環境)

  • Prod(生產環境) 不同類型的計算資源在不同的配置模式(ConnectionPropertiesMode)下具有不同的屬性資訊規範

UrlMode

Description

string

計算資源 ID,計算資源的唯一識別碼。

home_feed

CreateTime

integer

建立時間(時間戳記)

1624387842781448

CreateUser

string

建立者 ID。

1648711113000

ModifyTime

integer

計算資源的最近修改時間(時間戳記)。

1624387842781448

ModifyUser

string

計算資源的修改者 ID。

1648711113000

WhetherDefault

boolean

是否為預設計算資源

true

樣本

正常返回樣本

JSON格式

{
  "RequestId": "7C352CB7-CD88-50CF-9D0D-E81BDF02XXXX",
  "PagingInfo": {
    "TotalCount": 100,
    "PageSize": 10,
    "PageNumber": 1,
    "ComputeResources": [
      {
        "Name": "cal_all_vemg_workflow_parallel",
        "Type": "hologres",
        "ComputeResource": [
          {
            "Id": 8649832502405359000,
            "ConnectionProperties": "{\\n    \\\"clusterIdentifier\\\": \\\"c-da123456\\\",\\n    \\\"database\\\": \\\"testdb\\\",\\n    \\\"loginMode\\\":\\\"Anonymous\\\",\\n    \\\"defaultFS\\\":\\\"127.0.0.1\\\",\\n    \\\"envType\\\": \\\"Prod\\\"\\n}",
            "ConnectionPropertiesMode": "UrlMode",
            "Description": "home_feed",
            "CreateTime": 1624387842781448,
            "CreateUser": "1648711113000",
            "ModifyTime": 1624387842781448,
            "ModifyUser": "1648711113000",
            "WhetherDefault": true
          }
        ]
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情