Todos os produtos
Search
Central de documentação

Microservices Engine:QueryClusterDetail

Última atualização: Oct 22, 2026

Consulta os detalhes de um cluster.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

mse:QueryClusterDetail

get

*All resources.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceId

string

Não

O ID da instância.

mse-cn-st21ri2****

OrderId

string

Não

O ID do pedido.

20576750143****

AclSwitch

boolean

Não

Especifica se a lista de controle de acesso (ACL) deve ser consultada.

false

AcceptLanguage

string

Não

O idioma das informações retornadas. Valores válidos:

  • zh: Chinês.

  • en: Inglês.

zh

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O objeto de string.

Message

string

A mensagem retornada.

Request processed successfully

RequestId

string

O ID da solicitação.

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

Data

object

A visão geral dos dados.

VpcId

string

O ID da VPC.

vpc-bp1hcg467ekqsv0zr****

CreateTime

string

A hora em que o cluster foi criado.

2020-07-31 11:36:08

IntranetAddress

string

O endpoint privado.

192.168.XX.XX

DiskType

string

O tipo de disco.

alicloud-disk-ssd-multi-zone

PubNetworkFlow

string

A largura de banda da Internet. Unidade: Mbit/s. Valores válidos: 0 a 5000. Um valor de 0 indica que o cluster não está conectado à Internet.

3

DiskCapacity

integer

A capacidade do disco. Unidade: GB.

60

MemoryCapacity

integer

O tamanho da memória. Unidade: GB.

2

ClusterAliasName

string

O alias do cluster.

mse-7413****

InstanceCount

integer

O número de instâncias no cluster.

3

IntranetPort

string

A porta privada.

8761

InstanceModels

array<object>

A lista de instâncias.

object

O objeto de string.

PodName

string

O nome do pod.

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

SingleTunnelVip

string

O endereço IP de túnel único.

192.168.XX.XX

InternetIp

string

O endereço IP público.

47.98.XX.XX

Ip

string

O endereço IP da instância.

10.12.XX.XX

Role

string

A função.

Peer

HealthStatus

string

O status de integridade da instância.

Running

CreationTimestamp

string

O timestamp de criação.

1578575377732

Zone

string

A zona.

cn-shanghai-f

IntranetDomain

string

O nome de domínio privado.

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

InternetDomain

string

O nome de domínio público.

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

PayInfo

string

O método de cobrança, incluindo assinatura e pay-as-you-go.

Pay-as-you-go

InternetAddress

string

O endpoint público.

47.98.XX.XX

InstanceId

string

O ID da instância.

mse-cn-st21ri2****

AclEntryList

string

A lista de permissões.

[]

HealthStatus

string

O status de integridade do cluster.

RESTART_SUCCESS

InitCostTime

integer

O tempo necessário para criar o cluster. Unidade: ms.

98408

RegionId

string

O ID da região.

cn-hangzhou

AclId

string

O ID da lista de permissões.

acl-bp17020kiqvzutwwj****

Cpu

integer

O número de CPUs.

1

ClusterType

string

O tipo de cluster, incluindo ZooKeeper, Nacos-Ans e Eureka.

Nacos-Ans

ClusterName

string

O nome do cluster.

mse-bc1a29b0-160230875****

InitStatus

string

O status de criação do cluster.

RESTART_SUCCESS

InternetPort

string

A porta privada.

8761

AppVersion

string

A versão do aplicativo.

1.2.1

NetType

string

O tipo de rede. Valores válidos:

  • privatenet: VPC.

  • pubnet: Internet.

privatenet

ClusterVersion

string

A versão do cluster.

1.2.1

ClusterSpecification

string

As especificações do mecanismo.

MSE_SC_1_2_200_c

VSwitchId

string

O ID do vSwitch.

vsw-xxx-xxxx

ConnectionType

string

O tipo de conectividade de rede. Valores válidos:

  • slb

  • eni

slb

MseVersion

string

A versão do MSE.

mse_basic

ChargeType

string

O método de cobrança, incluindo assinatura e pay-as-you-go.

Pay-as-you-go

OrderClusterVersion

string

O número da versão do pedido original.

1.2.0

Tags

object

As tags vinculadas à instância.

ResourceGroupId

string

O ID do grupo de recursos.

rg-aek2dhgysj*****

VersionLifecycle

string

O ciclo de vida da versão.

STABLE

ErrorCode

string

O código de erro.

mse-100-000

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true: A solicitação foi bem-sucedida.

  • false: A solicitação falhou.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "请求处理成功",
  "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": "按量付费",
    "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": "按量付费",
    "OrderClusterVersion": "1.2.0",
    "Tags": {
      "test": "test",
      "test2": 1
    },
    "ResourceGroupId": "rg-aek2dhgysj*****",
    "VersionLifecycle": "STABLE"
  },
  "ErrorCode": "mse-100-000",
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 IllegalRequest Invalid request:%s
400 InvalidParameter Parameter error:%s Parâmetros de solicitação inválidos: %s.
500 InternalError Console error. Try again later:%s Ocorreu um erro no console. Tente novamente mais tarde: %s.
403 NoPermission You are not authorized to perform this operation:%s Você não tem permissão para usar esta operação: %s.
404 NotFound Not found:%s O recurso não existe: %s.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.