Todos os produtos
Search
Central de documentação

Application Real-Time Monitoring Service:QueryAppTopology

Última atualização: Jul 04, 2026

Consulta a topologia de uma aplicação.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região.

cn-hangzhou

Pid

string

Não

O ID da aplicação.

Faça login no console do ARMS. No painel de navegação à esquerda, escolha Monitoramento do Navegador > Monitoramento do Navegador. Na página Monitoramento do Navegador, clique no nome de uma aplicação. A URL na barra de endereços contém o ID do processo (PID) da aplicação. O PID é indicado no formato pid=xxx. O PID geralmente é codificado em porcentagem como xxx%40xxx. Você deve modificar este valor para remover a codificação por porcentagem. Por exemplo, se o PID na URL for eb4zdose6v%409781be0f44d****, você deve substituir %40 por um sinal de arroba (@) para obter eb4zdose6v@9781be0f44d****.

atc889zkcf@d8deedfa9bf****

AppType

string

Não

O tipo de aplicação.

TRACE

Type

string

Sim

O tipo de topologia.

Valores válidos:

  • apm_txn :
  • apm_app_v2 :
  • apm_database_v2 :
  • apm_apps :
  • apm_app :
  • apm_txn_v2 :
  • apm_database :
  • apm_apps_v2 :

apm_apps_v2

Rpc

string

Não

O nome da interface RPC.

/eventCenter

Db

string

Não

O nome de domínio do banco de dados.

rm-xxx.mysql.rds.aliyuncs.com:3306

DbName

string

Não

O nome do banco de dados.

orders

StartTime

integer

Sim

O início do intervalo de tempo a ser consultado. Unidade: milissegundos.

1595568910000

EndTime

integer

Sim

O fim do intervalo de tempo a ser consultado. Unidade: milissegundos.

1671952708499

Filters

object

Não

As condições de filtro.

string

Não

As condições de filtro.

"rootIp":"127.0.0.1"

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

78901766-3806-4E96-8E47-CFEF59E4****

Success

boolean

Indica se a chamada foi bem-sucedida. Valores válidos:

  • true: A chamada foi bem-sucedida.

  • false: A chamada falhou.

true

Code

integer

O código de status. O código de status 200 indica que a solicitação foi bem-sucedida. Se outro código de status for retornado, a solicitação falhou.

200

Message

string

A mensagem de erro.

null

Data

any

A estrutura retornada.

"Data": { "nodes": [ { "data": { "duration": 0.2254335260115607, "requests": 1211, "type": "MYSQL", "errors": 0 }, "id": "ggxw4lnjuz@c0507xxxx##MYSQL", "label": "mysql-pod:3306(cart_db)" } ], "edges": [ { "data": { "duration": 0.03333333333333333, "requests": 600, "type": "UNKNOWN", "errors": 0 }, "id": "1974097372", "source": "ggxw4lnjuz@456xxxxx", "target": "ggxw4lnjuz@c0507xxxx" } ] }

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "78901766-3806-4E96-8E47-CFEF59E4****",
  "Success": true,
  "Code": 200,
  "Message": "null",
  "Data": "\"Data\": {\n    \"nodes\": [\n      {\n        \"data\": {\n          \"duration\": 0.2254335260115607,\n          \"requests\": 1211,\n          \"type\": \"MYSQL\",\n          \"errors\": 0\n        },\n        \"id\": \"ggxw4lnjuz@c0507xxxx##MYSQL\",\n        \"label\": \"mysql-pod:3306(cart_db)\"\n      }\n    ],\n    \"edges\": [\n      {\n        \"data\": {\n          \"duration\": 0.03333333333333333,\n          \"requests\": 600,\n          \"type\": \"UNKNOWN\",\n          \"errors\": 0\n        },\n        \"id\": \"1974097372\",\n        \"source\": \"ggxw4lnjuz@456xxxxx\",\n        \"target\": \"ggxw4lnjuz@c0507xxxx\"\n      }\n    ]\n  }"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ParameterMissing You must specify the parameter. You must specify the parameter.
400 ParameterRegionIdMissing You must specify regionId. You must specify regionId.
400 ParameterTopologyTypeIllegal The specified topologyType is invalid. The specified topologyType is invalid.
400 ParameterTimeStampIllegal The specified timeStamp is invalid. The specified timeStamp is invalid.
500 InternalError Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries. Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.
403 APINotAuthorize The current user is not authorized to access the interface. The current user is not authorized to access the interface.
404 AppNotExist The application does not exist. The application does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.