全部產品
Search
文件中心

Application Real-Time Monitoring Service:QueryAppTopology - 查詢拓撲圖

更新時間:Apr 10, 2026

查詢應用拓撲。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

地區 ID。

cn-hangzhou

Pid

string

應用 ID。

atc889zkcf@d8deedfa9bf****

AppType

string

應用類型,XTRACE、EBPF 需要填寫,預設不填。

TRACE

Type

string

拓撲查詢類型。

枚舉值:

  • apm_txn :

    應用詳情-介面調用拓撲圖介面

  • apm_app_v2 :

    應用詳情-應用拓撲圖介面 V2

  • apm_database_v2 :

    應用詳情-資料庫調用拓撲圖介面 V2

  • apm_apps :

    應用列表-總覽拓撲圖介面

  • apm_app :

    應用詳情-應用拓撲圖介面

  • apm_txn_v2 :

    應用詳情-介面調用拓撲圖介面 V2

  • apm_database :

    應用詳情-資料庫調用拓撲圖介面

  • apm_apps_v2 :

    應用列表-總覽拓撲圖介面 V2

apm_apps_v2

Rpc

string

RPC 介面名。

/eventCenter

Db

string

資料庫網域名稱。

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

DbName

string

資料庫名稱。

orders

StartTime

integer

起始時間的時間戳記,精確到毫秒。

1595568910000

EndTime

integer

結束時間的時間戳記,精確到毫秒。

1671952708499

Filters

object

篩選條件組合。

string

篩選條件組合。

"rootIp":"127.0.0.1"

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID。

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

Success

boolean

查詢是否成功:true:成功。 false:失敗。

true

Code

integer

介面狀態,取值說明如下:2XX:成功。3XX:重新導向。4XX:請求錯誤。5XX:伺服器錯誤。

200

Message

string

調用失敗時返回的資訊。

null

Data

any

返回資訊。

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

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ParameterMissing You must specify the parameter. 必選參數缺失
400 ParameterRegionIdMissing You must specify regionId. 參數regionId缺失
400 ParameterTopologyTypeIllegal The specified topologyType is invalid. 參數topoloyType非法
400 ParameterTimeStampIllegal The specified timeStamp is invalid. 時間參數非法
500 InternalError Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries. 內部錯誤,建議重試。如果多次重試報錯請聯絡DingTalk服務帳號。
403 APINotAuthorize The current user is not authorized to access the interface. 目前使用者無許可權訪問該介面
404 AppNotExist The application does not exist. 應用不存在

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

變更歷史

更多資訊,參考變更詳情