All Products
Search
Document Center

Microservices Engine:QueryClusterInfo

Last Updated:Jun 10, 2026

Mengkueri informasi statis tentang sebuah cluster.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mse:QueryClusterInfo

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ClusterId

string

No

ID cluster.

mse-09k1q11****

InstanceId

string

No

ID instans.

mse_prepaid_public_cn-7mz2t63ci03

OrderId

string

No

ID pesanan.

20574710974****

AclSwitch

boolean

No

Apakah akan mengkueri daftar putih jaringan publik.

false

RegionId

string

No

ID wilayah.

cn-hangzhou

RequestPars

string

No

Parameter permintaan tambahan dalam format JSON.

{}

AcceptLanguage

string

No

Bahasa respons. Nilai valid:

  • zh: Mandarin

  • en: Inggris.

zh

Elemen respons

Element

Type

Description

Example

object

The data structure of the response.

Message

string

The response message.

  • A success message is returned for a successful request.

  • An error message is returned for a failed request.

请求处理成功

RequestId

string

The request ID.

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

Data

object

The returned data.

VpcId

string

The ID of the VPC that contains the cluster.

vpc-bp1v5nbauzh8xxxxxxx

CreateTime

string

The time the cluster was created.

2022-12-15 10:02:07

IntranetAddress

string

This parameter is reserved.

null

DiskType

string

This parameter is deprecated.

null

PubNetworkFlow

string

The public bandwidth in Mbps.
Valid values: 0 to 5000. A value of 0 indicates that the public endpoint is disabled.

1

DiskCapacity

integer

This parameter is deprecated.

null

MemoryCapacity

integer

This parameter is deprecated.

null

ClusterAliasName

string

The alias of the cluster.

开发环境

InstanceCount

integer

The number of instances in the cluster.

3

IntranetPort

string

The ports that are open on the cluster's internal network.

8848,6443,9848,8761

InstanceModels

array<object>

This parameter is reserved.

object

This parameter is reserved.

PodName

string

Reserved field.

null

SingleTunnelVip

string

Reserved field.

null

InternetIp

string

Reserved field.

null

Ip

string

Reserved field.

null

Role

string

Reserved field.

null

HealthStatus

string

Reserved field.

null

CreationTimestamp

string

Reserved field.

null

Zone

string

Reserved field.

null

IntranetDomain

string

The cluster's internal domain name.

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

InternetDomain

string

The cluster's public domain name.

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

PayInfo

string

The billing method.

按量付费

InternetAddress

string

This parameter is reserved.

null

InstanceId

string

The instance ID.

mse-cn-st21ri2****

AclEntryList

string

The IP whitelist for public access.

["127.0.0.0/32"]

HealthStatus

string

The health status of the cluster.

INIT_SUCCESS

InitCostTime

integer

The time taken to initialize the cluster, in milliseconds.

53353

RegionId

string

The region ID.

cn-hangzhou

AclId

string

The ID of the public access IP whitelist.

acl-bp144q24cgqvzckmxxxx

Cpu

integer

This parameter is deprecated.

null

ClusterType

string

The type of the cluster. Valid values: ZooKeeper, Nacos-Ans, and Eureka.

Nacos-Ans

ClusterName

string

The cluster's full name.

mse-74355150-xxxxxxx

InitStatus

string

The initialization status of the cluster.

INIT_SUCCESS

InternetPort

string

The ports that are open on the cluster's public network.

8848,6443,9848,8761

AppVersion

string

The cluster version.

2.1.0

NetType

string

The cluster's network connection type.

privatenet

ClusterVersion

string

The cluster edition.

NACOS_2_0_0

ClusterSpecification

string

The cluster's engine specification.

MSE_SC_2_4_60_c

VSwitchId

string

The ID of the vSwitch.

vsw-bp1egfakxxxxx

ConnectionType

string

This parameter is deprecated.

null

MseVersion

string

The edition of the MSE instance.

mse_pro

ChargeType

string

The cluster's billing method. Valid values: PREPAY (subscription) and POSTPAY (pay-as-you-go).

POSTPAY

Tags

object

The tags attached to the cluster.

ExpectZones

array

A list of availability zones in which the cluster can be deployed.

string

An availability zone ID.

cn-hangzhou-k

MaintenancePeriod

object

The maintenance window.

EndTime

string

O&M time window start time

02:00

StartTime

string

O&M time window end time

06:00

EndDate

string

The expiration date of the subscription-based cluster.

2021-08-01 00:00:00

SecurityGroupId

string

The security group ID of the Elastic Network Interface (ENI).

sg-uf6hgwe067prhg68agfa

SecurityGroupType

string

The type of the security group for the ENI.

enterprise

EipInstanceId

string

The instance ID of the Elastic IP Address (EIP).

eip-bp1uujshd5funmyy8rcl9

CanUpdate

boolean

Indicates whether the cluster can be upgraded to a later minor version.

true

VersionCode

string

The current version code of the cluster.

NACOS_2_1_0_1

VersionLifecycle

string

The version lifecycle.

ErrorCode

string

The error code.

mse-100-000

Success

boolean

Indicates whether the request was successful. Valid values:

  • true: The request was successful.

  • false: The request failed.

true

Contoh

Respons sukses

JSONformat

{
  "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
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalRequest Invalid request:%s
400 InvalidParameter Parameter error:%s
500 InternalError Console error. Try again later:%s
403 NoPermission You are not authorized to perform this operation:%s
404 NotFound Not found:%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.