全部產品
Search

搜尋本產品

    Enterprise Distributed Application Service：GetCluster - 擷取叢集資訊

    文件中心

    Enterprise Distributed Application Service：GetCluster - 擷取叢集資訊

    更新時間：Dec 22, 2025

    擷取指定叢集的資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    edas:ReadCluster

    get

    *Cluster

    acs:edas:{#regionId}:{#accountId}:namespace/{#NameSpaceId}/cluster/{#ClusterId}

    		 無 無

    請求文法

    GET /pop/v5/resource/cluster HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ClusterId

    string

    是

    叢集 ID。可以通過調用 ListCluster 擷取叢集 ID，具體操作，請參見 ListCluster 。

    5439271a-015b-433d-****-d76db49****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Code

    integer

    code 碼。

    200
    Message

    string

    詳細資料。

    success
    RequestId

    string

    請求 ID。

    d76db491
    Cluster

    object

    叢集資訊。

    VpcId

    string

    VPC 網路識別碼。

    vpc-xxxxz1mlwpb****
    OversoldFactor

    integer

    Docker 叢集 CPU 超賣：

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

    • 2：1:2 比例超賣

    • 4：1:4 比例超賣

    • 8：1:8 比例超賣

    2
    UpdateTime

    integer

    最後變更時間的時間戳記。

    1570708232145
    MemUsed

    integer

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

    1024
    IaasProvider

    string

    IaaS 資源提供者。

    ALIYUN
    CreateTime

    integer

    叢集建立時間的時間戳記。

    1570708232145
    CpuUsed

    integer

    已使用 CPU 核心數。

    2
    Mem

    integer

    記憶體總量，單位為 MB。

    2048
    RegionId

    string

    地區 ID。

    cn-hangzhou
    Cpu

    integer

    CPU 總核心數。

    4
    CsClusterId

    string

    Container Service叢集 ID。

    c2ce62869f4d4466b920312315f05****
    NetworkMode

    integer

    網路類型：

    • 1：傳統網路。

    • 2：VPC。

    2
    Description

    string

    描述。

    測試
    ClusterType

    integer

    叢集類型。

    • 0：普通 Docker 叢集

    • 1：Swarm 叢集

    • 2：ECS 叢集

    • 3：EDAS 自建 K8s 叢集

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

    • 5：Container Service K8s 叢集

    2
    ClusterName

    string

    叢集名稱。

    ClusterTest
    NodeNum

    integer

    ECS 數量。

    4
    ClusterImportStatus

    integer

    匯入叢集狀態。

    • 1：匯入成功

    • 2：匯入失敗

    • 3：正在匯入

    • 4：叢集已刪除

    • 0：未匯入

    0
    ClusterId

    string

    叢集 ID。

    5439271a-015b-433d-befb-d76d****
    SubClusterType

    string

    K8s 類型叢集的子類型：ManagedKubernetes 為阿里雲 ACK 叢集類型， Ask 為阿里雲 ASK 叢集類型， ExternalKubernetes 為外部叢集類型。

    ManagedKubernetes

    樣本

    正常返回樣本

    JSON格式

    {
  "Code": 200,
  "Message": "success",
  "RequestId": "d76db491",
  "Cluster": {
    "VpcId": "vpc-xxxxz1mlwpb****",
    "OversoldFactor": 2,
    "UpdateTime": 1570708232145,
    "MemUsed": 1024,
    "IaasProvider": "ALIYUN",
    "CreateTime": 1570708232145,
    "CpuUsed": 2,
    "Mem": 2048,
    "RegionId": "cn-hangzhou",
    "Cpu": 4,
    "CsClusterId": "c2ce62869f4d4466b920312315f05****",
    "NetworkMode": 2,
    "Description": "測試",
    "ClusterType": 2,
    "ClusterName": "ClusterTest",
    "NodeNum": 4,
    "ClusterImportStatus": 0,
    "ClusterId": "5439271a-015b-433d-befb-d76d****",
    "SubClusterType": "ManagedKubernetes"
  }
}

    錯誤碼

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

    變更歷史

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