全部產品
Search

搜尋本產品

    Enterprise Distributed Application Service：ListCluster - 擷取叢集列表

    文件中心

    Enterprise Distributed Application Service：ListCluster - 擷取叢集列表

    更新時間：Dec 22, 2025

    擷取叢集列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    edas:ReadCluster

    list

    *全部資源

    *

    		 無 無

    請求文法

    POST /pop/v5/resource/cluster_list HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    LogicalRegionId

    string

    否

    命名空間的 ID。查詢命名空間 ID，請參見 ListUserDefineRegion 。

    • 未設定該參數，則查詢預設命名空間的叢集列表。

    • 設定該參數，則查詢指定命名空間的叢集列表。

    cn-beijing:test
    ResourceGroupId

    string

    否

    資源群組 ID。查詢資源群組 ID，請參見 ListResourceGroup 。

    • 未設定該參數，則查詢預設資源群組的叢集列表。

    • 設定該參數，則查詢指定資源群組的叢集列表。

    461

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Code

    integer

    介面狀態或 POP 錯誤碼

    200
    Message

    string

    附加資訊

    success
    RequestId

    string

    請求 ID

    1053-08e4-47a5-b2ab-5c0323de****
    ClusterList

    object

    Cluster

    array<object>

    叢集列表

    object

    VpcId

    string

    VPC ID

    vpc-23727****
    OversoldFactor

    integer

    Docker 叢集支援的 CPU 超賣比例。

    • 1：1:1 比例，不超賣

    • 2：1:2 比例

    • 4：1:4 比例

    • 8：1:8 比例

    1
    UpdateTime

    integer

    最後變更時間的時間戳記

    1533820823203
    MemUsed

    integer

    已使用記憶體，單位為 MB。

    200
    IaasProvider

    string

    叢集供應商

    ALIYUN
    CreateTime

    integer

    建立時間的時間戳記

    1502888064561
    CpuUsed

    integer

    已使用 CPU 核心數

    1
    Mem

    integer

    總記憶體，單位為 MB。

    3072
    RegionId

    string

    地區 ID

    cn-beijing
    Cpu

    integer

    總 CPU 核心數

    2
    CsClusterId

    string

    Container Service Kubernetes 版中建立的 K8s 叢集的 ID

    c2ce************b9203a9
    NetworkMode

    integer

    網路類型。

    • 1：傳統網路

    • 2：VPC

    1
    Description

    string

    叢集描述

    測試叢集
    ClusterType

    integer

    叢集類型。

    • 0：普通 Docker 叢集

    • 1：Swarm 叢集

    • 2：ECS 叢集

    • 3：EDAS 自建 K8s 叢集

    • 4：Pandora 自動註冊應用叢集

    • 5：Container Service K8s 叢集

    2
    ResourceGroupId

    string

    資源群組 ID

    461
    ClusterName

    string

    叢集名稱

    cluster-test
    NodeNum

    integer

    執行個體數量

    2
    ClusterId

    string

    EDAS 中的叢集 ID

    b98b5919-c111-4dad-9f74-7233********

    樣本

    正常返回樣本

    JSON格式

    {
  "Code": 200,
  "Message": "success",
  "RequestId": "1053-08e4-47a5-b2ab-5c0323de****",
  "ClusterList": {
    "Cluster": [
      {
        "VpcId": "vpc-23727****",
        "OversoldFactor": 1,
        "UpdateTime": 1533820823203,
        "MemUsed": 200,
        "IaasProvider": "ALIYUN",
        "CreateTime": 1502888064561,
        "CpuUsed": 1,
        "Mem": 3072,
        "RegionId": "cn-beijing",
        "Cpu": 2,
        "CsClusterId": "c2ce************b9203a9",
        "NetworkMode": 1,
        "Description": "測試叢集",
        "ClusterType": 2,
        "ResourceGroupId": "461",
        "ClusterName": "cluster-test",
        "NodeNum": 2,
        "ClusterId": "b98b5919-c111-4dad-9f74-7233********"
      }
    ]
  }
}

    錯誤碼

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

    變更歷史

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