全部产品
Search
文档中心

Microservices Engine:QueryClusterDetail

更新时间:Dec 16, 2025

Mengambil detail kluster.

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:QueryClusterDetail

get

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

No

ID instans.

mse-cn-st21ri2****

OrderId

string

No

ID pesanan.

20576750143****

AclSwitch

boolean

No

Menentukan apakah akan menanyakan daftar kontrol akses (ACL).

false

AcceptLanguage

string

No

Bahasa respons. Nilai yang valid:

  • zh: Bahasa Tiongkok

  • en: Bahasa Inggris

zh

Elemen respons

Element

Type

Description

Example

object

Objek string.

Message

string

Pesan yang dikembalikan.

The request is successfully processed.

RequestId

string

ID permintaan.

9515ACA4-E94D-440D-989E-C379FCED****

Data

object

Data yang dikembalikan.

VpcId

string

ID virtual private cloud (VPC).

vpc-bp1hcg467ekqsv0zr****

CreateTime

string

Waktu pembuatan kluster.

2020-07-31 11:36:08

IntranetAddress

string

Titik akhir pribadi.

192.168.XX.XX

DiskType

string

Jenis disk.

alicloud-disk-ssd-multi-zone

PubNetworkFlow

string

Bandwidth publik. Satuan: Mbit/s.
Nilai yang valid: 0 hingga 5000. Nilai 0 menunjukkan tidak ada bandwidth publik yang digunakan.

3

DiskCapacity

integer

Kapasitas disk. Satuan: GB.

60

MemoryCapacity

integer

Kapasitas memori. Satuan: GB.

2

ClusterAliasName

string

Alias kluster.

mse-7413****

InstanceCount

integer

Jumlah instans dalam kluster.

3

IntranetPort

string

Port pribadi.

8761

InstanceModels

array<object>

Daftar instans.

object

String.

PodName

string

Nama Pod.

mse-7413****-159616656****-reg-center-0-0

SingleTunnelVip

string

Alamat IP single-threaded.

192.168.XX.XX

InternetIp

string

Alamat IP publik.

47.98.XX.XX

Ip

string

Alamat IP instans.

10.12.XX.XX

Role

string

Peran instans.

Peer

HealthStatus

string

Status kesehatan instans.

Running

CreationTimestamp

string

Timestamp yang menunjukkan waktu pembuatan instans.

1578575377732

Zone

string

Zona.

cn-shanghai-f

IntranetDomain

string

Titik akhir pribadi.

mse-7413****-eureka.mse.aliyuncs.com

InternetDomain

string

Titik akhir publik.

mse-7413****-p.eureka.mse.aliyuncs.com

PayInfo

string

Metode penagihan. Nilai yang valid meliputi subscription dan pay-as-you-go.

Pay-as-you-go

InternetAddress

string

Alamat IP publik.

47.98.XX.XX

InstanceId

string

ID instans.

mse-cn-st21ri2****

AclEntryList

string

Daftar putih.

[]

HealthStatus

string

Status kesehatan kluster.

RESTART_SUCCESS

InitCostTime

integer

Waktu yang dibutuhkan untuk membuat kluster. Satuan: ms.

98408

RegionId

string

ID wilayah.

cn-hangzhou

AclId

string

ID daftar putih.

acl-bp17020kiqvzutwwj****

Cpu

integer

Jumlah core CPU.

1

ClusterType

string

Jenis kluster. Nilai yang valid: ZooKeeper, Nacos-Ans, dan Eureka.

Nacos-Ans

ClusterName

string

Nama kluster.

mse-bc1a29b0-160230875****

InitStatus

string

Status pembuatan kluster.

RESTART_SUCCESS

InternetPort

string

Port jaringan pribadi.

8761

AppVersion

string

Versi aplikasi.

1.2.1

NetType

string

Jenis jaringan. Nilai yang valid:

  • privatenet: VPC.

  • pubnet: jaringan publik.

privatenet

ClusterVersion

string

Versi kluster.

1.2.1

ClusterSpecification

string

Spesifikasi engine.

MSE_SC_1_2_200_c

VSwitchId

string

ID vSwitch.

vsw-xxx-xxxx

ConnectionType

string

Jenis koneksi jaringan. Nilai yang valid:

  • slb

  • eni

slb

MseVersion

string

Versi MSE.

mse_basic

ChargeType

string

Metode penagihan. Nilai yang valid adalah subscription dan pay-as-you-go.

Pay-as-you-go

OrderClusterVersion

string

Versi kluster dalam pesanan asli.

1.2.0

Tags

object

Tag yang dilampirkan pada instans.

ResourceGroupId

string

ID kelompok sumber daya.

rg-aek2dhgysj*****

VersionLifecycle

string

ErrorCode

string

Kode kesalahan.

mse-100-000

Success

boolean

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

Contoh

Respons sukses

JSONformat

{
  "Message": "The request is successfully processed.\n",
  "RequestId": "9515ACA4-E94D-440D-989E-C379FCED****",
  "Data": {
    "VpcId": "vpc-bp1hcg467ekqsv0zr****",
    "CreateTime": "2020-07-31 11:36:08",
    "IntranetAddress": "192.168.XX.XX",
    "DiskType": "alicloud-disk-ssd-multi-zone",
    "PubNetworkFlow": "3",
    "DiskCapacity": 60,
    "MemoryCapacity": 2,
    "ClusterAliasName": "mse-7413****",
    "InstanceCount": 3,
    "IntranetPort": "8761",
    "InstanceModels": [
      {
        "PodName": "mse-7413****-159616656****-reg-center-0-0",
        "SingleTunnelVip": "192.168.XX.XX",
        "InternetIp": "47.98.XX.XX",
        "Ip": "10.12.XX.XX",
        "Role": "Peer",
        "HealthStatus": "Running",
        "CreationTimestamp": "1578575377732",
        "Zone": "cn-shanghai-f"
      }
    ],
    "IntranetDomain": "mse-7413****-eureka.mse.aliyuncs.com",
    "InternetDomain": "mse-7413****-p.eureka.mse.aliyuncs.com",
    "PayInfo": "Pay-as-you-go\n",
    "InternetAddress": "47.98.XX.XX",
    "InstanceId": "mse-cn-st21ri2****",
    "AclEntryList": "[]",
    "HealthStatus": "RESTART_SUCCESS",
    "InitCostTime": 98408,
    "RegionId": "cn-hangzhou",
    "AclId": "acl-bp17020kiqvzutwwj****",
    "Cpu": 1,
    "ClusterType": "Nacos-Ans",
    "ClusterName": "mse-bc1a29b0-160230875****",
    "InitStatus": "RESTART_SUCCESS",
    "InternetPort": "8761",
    "AppVersion": "1.2.1",
    "NetType": "privatenet",
    "ClusterVersion": "1.2.1",
    "ClusterSpecification": "MSE_SC_1_2_200_c",
    "VSwitchId": "vsw-xxx-xxxx",
    "ConnectionType": "slb",
    "MseVersion": "mse_basic",
    "ChargeType": "Pay-as-you-go\n",
    "OrderClusterVersion": "1.2.0",
    "Tags": {
      "test": "test",
      "test2": 1
    },
    "ResourceGroupId": "rg-aek2dhgysj*****",
    "VersionLifecycle": ""
  },
  "ErrorCode": "mse-100-000",
  "Success": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalRequest Invalid request:%s Invalid request: %s
400 InvalidParameter Parameter error:%s Request parameter error: %s
500 InternalError Console error. Try again later:%s Console error. Try again later: %s
403 NoPermission You are not authorized to perform this operation:%s You do not have the permission to use this interface:%s
404 NotFound Not found:%s The resource does not exist:%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.