全部產品
Search

搜尋本產品

    Microservices Engine：QueryClusterInfo - 查詢叢集靜態資訊

    文件中心

    Microservices Engine：QueryClusterInfo - 查詢叢集靜態資訊

    更新時間：Apr 21, 2026

    查詢叢集的靜態資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mse:QueryClusterInfo

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ClusterId

    string

    否

    叢集 ID。

    mse-09k1q11****
    InstanceId

    string

    否

    執行個體 ID。

    mse_prepaid_public_cn-7mz2t63ci03
    OrderId

    string

    否

    訂單 ID。

    20574710974****
    AclSwitch

    boolean

    否

    是否查詢公網白名單配置。

    false
    RegionId

    string

    否

    地區 ID。

    cn-hangzhou
    RequestPars

    string

    否

    擴充請求參數，JSON 格式。

    {}
    AcceptLanguage

    string

    否

    返回資訊的語言類型：

    • zh：中文

    • en：英文

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    資料結構。

    Message

    string

    返回資訊。

    • 當請求成功時，返回成功資訊。

    • 當請求失敗時，返回失敗原因。

    請求處理成功
    RequestId

    string

    請求 ID。

    415088B3-A7BE-56F6-9CD9-C42DE895CD41
    Data

    object

    資料概覽。

    VpcId

    string

    叢集所處的 VPC ID。

    vpc-bp1v5nbauzh8xxxxxxx
    CreateTime

    string

    叢集建立時間。

    2022-12-15 10:02:07
    IntranetAddress

    string

    預留欄位。

    null
    DiskType

    string

    廢棄欄位。

    null
    PubNetworkFlow

    string

    公網頻寬，單位：Mbps。
    取值範圍：0~5000，其中 0 表示不接入公網。

    1
    DiskCapacity

    integer

    廢棄欄位。

    null
    MemoryCapacity

    integer

    廢棄欄位。

    null
    ClusterAliasName

    string

    叢集別名。

    開發環境
    InstanceCount

    integer

    叢集執行個體數。

    3
    IntranetPort

    string

    叢集內網開放的連接埠。

    8848,6443,9848,8761
    InstanceModels

    array<object>

    預留結構。

    object

    預留結構。

    PodName

    string

    預留欄位。

    null
    SingleTunnelVip

    string

    預留欄位。

    null
    InternetIp

    string

    預留欄位。

    null
    Ip

    string

    預留欄位。

    null
    Role

    string

    預留欄位。

    null
    HealthStatus

    string

    預留欄位。

    null
    CreationTimestamp

    string

    預留欄位。

    null
    Zone

    string

    預留欄位。

    null
    IntranetDomain

    string

    內網網域名稱。

    mse-xxxxx-nacos-ans.mse.aliyuncs.com
    InternetDomain

    string

    公網網域名稱。

    mse-xxxxxx-p.nacos-ans.mse.aliyuncs.com
    PayInfo

    string

    付費方式。

    隨用隨付
    InternetAddress

    string

    預留欄位。

    null
    InstanceId

    string

    執行個體 ID。

    mse-cn-st21ri2****
    AclEntryList

    string

    公網白名單。

    ["127.0.0.0/32"]
    HealthStatus

    string

    叢集狀態。

    INIT_SUCCESS
    InitCostTime

    integer

    叢集初始化所用的時間（毫秒）。

    53353
    RegionId

    string

    地區 ID。

    cn-hangzhou
    AclId

    string

    公網白名單一實例 ID

    acl-bp144q24cgqvzckmxxxx
    Cpu

    integer

    廢棄欄位。

    null
    ClusterType

    string

    叢集類型，包括 ZooKeeper、Nacos-Ans 和 Eureka。

    Nacos-Ans
    ClusterName

    string

    叢集完整名稱。

    mse-74355150-xxxxxxx
    InitStatus

    string

    初始化狀態。

    INIT_SUCCESS
    InternetPort

    string

    公網叢集開放連接埠。

    8848,6443,9848,8761
    AppVersion

    string

    叢集版本號碼。

    2.1.0
    NetType

    string

    叢集網路連接類型。

    privatenet
    ClusterVersion

    string

    訂單版本。

    NACOS_2_0_0
    ClusterSpecification

    string

    引擎規格。

    MSE_SC_2_4_60_c
    VSwitchId

    string

    交換器 ID。

    vsw-bp1egfakxxxxx
    ConnectionType

    string

    廢棄欄位。

    null
    MseVersion

    string

    叢集版本。

    mse_pro
    ChargeType

    string

    付費模式，包括訂用帳戶和隨用隨付。

    POSTPAY
    Tags

    object

    標籤。

    ExpectZones

    array

    當前叢集可打散到的可用性區域列表。

    string

    可用性區域 ID。

    cn-hangzhou-k
    MaintenancePeriod

    object

    營運時間視窗

    EndTime

    string

    營運時間視窗開始時間

    02:00
    StartTime

    string

    營運時間視窗結束時間

    06:00
    EndDate

    string

    到期時間（訂用帳戶）

    2021-08-01 00:00:00
    SecurityGroupId

    string

    ENI 網路接入的安全性群組 ID

    sg-uf6hgwe067prhg68agfa
    SecurityGroupType

    string

    ENI 網路接入的安全性群組類型

    enterprise
    EipInstanceId

    string

    彈性公網 IP（EIP）的執行個體 ID

    eip-bp1uujshd5funmyy8rcl9
    CanUpdate

    boolean

    叢集是否有小版本可以升級

    true
    VersionCode

    string

    叢集目前的版本 Code

    NACOS_2_1_0_1
    VersionLifecycle

    string

    版本生命週期。

    ErrorCode

    string

    錯誤碼。

    mse-100-000
    Success

    boolean

    請求結果，取值如下：

    • true：請求成功。

    • false：請求失敗。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "Message": "請求處理成功",
  "RequestId": "415088B3-A7BE-56F6-9CD9-C42DE895CD41",
  "Data": {
    "VpcId": "vpc-bp1v5nbauzh8xxxxxxx",
    "CreateTime": "2022-12-15 10:02:07",
    "IntranetAddress": "null",
    "DiskType": "null",
    "PubNetworkFlow": "1",
    "DiskCapacity": 0,
    "MemoryCapacity": 0,
    "ClusterAliasName": "開發環境",
    "InstanceCount": 3,
    "IntranetPort": "8848,6443,9848,8761",
    "InstanceModels": [
      {
        "PodName": "null",
        "SingleTunnelVip": "null",
        "InternetIp": "null",
        "Ip": "null",
        "Role": "null",
        "HealthStatus": "null",
        "CreationTimestamp": "null",
        "Zone": "null"
      }
    ],
    "IntranetDomain": "mse-xxxxx-nacos-ans.mse.aliyuncs.com",
    "InternetDomain": "mse-xxxxxx-p.nacos-ans.mse.aliyuncs.com",
    "PayInfo": "隨用隨付",
    "InternetAddress": "null",
    "InstanceId": "mse-cn-st21ri2****",
    "AclEntryList": "[\"127.0.0.0/32\"]",
    "HealthStatus": "INIT_SUCCESS",
    "InitCostTime": 53353,
    "RegionId": "cn-hangzhou",
    "AclId": "acl-bp144q24cgqvzckmxxxx",
    "Cpu": 0,
    "ClusterType": "Nacos-Ans",
    "ClusterName": "mse-74355150-xxxxxxx",
    "InitStatus": "INIT_SUCCESS",
    "InternetPort": "8848,6443,9848,8761",
    "AppVersion": "2.1.0",
    "NetType": "privatenet",
    "ClusterVersion": "NACOS_2_0_0",
    "ClusterSpecification": "MSE_SC_2_4_60_c",
    "VSwitchId": "vsw-bp1egfakxxxxx",
    "ConnectionType": "null",
    "MseVersion": "mse_pro",
    "ChargeType": "POSTPAY",
    "Tags": {
      "test": "test",
      "test2": 1
    },
    "ExpectZones": [
      "cn-hangzhou-k"
    ],
    "MaintenancePeriod": {
      "EndTime": "02:00",
      "StartTime": "06:00"
    },
    "EndDate": "2021-08-01 00:00:00",
    "SecurityGroupId": "sg-uf6hgwe067prhg68agfa",
    "SecurityGroupType": "enterprise",
    "EipInstanceId": "eip-bp1uujshd5funmyy8rcl9",
    "CanUpdate": true,
    "VersionCode": "NACOS_2_1_0_1",
    "VersionLifecycle": ""
  },
  "ErrorCode": "mse-100-000",
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalRequest Invalid request:%s 非法請求： %s
    400 InvalidParameter Parameter error:%s 請求參數錯誤：%s
    500 InternalError Console error. Try again later:%s 控制台錯誤.稍後重試：%s
    403 NoPermission You are not authorized to perform this operation:%s 沒有許可權使用此介面：%s
    404 NotFound Not found:%s 資源不存在：%s

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

    變更歷史

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