更新时间:2025-11-05 GMT+08:00
分享

获取应用树- ShowTopologyTree

功能介绍

获取应用树。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    apm::getTopology

    Read

    -

    -

    • apm:apm2BusinessTopology:get
    • apm:apm2TraceTopology:get

    -

URI

GET /v1/apm2/openapi/cmdb/topology-trees/get-topology-trees

表1 Query参数

参数

是否必选

参数类型

描述

region_id

String

区域id。

business_id

Long

应用id。

env_tag_id

Long

环境标签id。

env_keyword

String

环境关键字。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

x-business-id

Long

应用id。

X-Auth-Token

String

从IAM服务获取的用户Token。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

topology_tree

TopologyTree object

拓扑树信息。

表4 TopologyTree

参数

参数类型

描述

tree

Array of TreeNode objects

拓扑树节点。

表5 TreeNode

参数

参数类型

描述

id

String

拓扑树节点id。

parent

String

拓扑树节点的父节点。

real_id

Long

拓扑树节点的实际id。

name

String

拓扑树节点名称。

display_name

String

拓扑树节点展示名称。

app_name

String

组件名称。

app_id

Long

组件id。

is_admin

Boolean

是否是管理节点。

is_root

Boolean

是否是根节点。

business_id

Long

应用id。

node_type

String

节点类型。

枚举值:

  • BUSINESS
  • SUB_BUSINESS
  • APPLICATION
  • ENVIRONMENT

region

String

区域。

is_default

Boolean

是否是默认的节点。

请求示例

获取应用ID为162的拓扑树信息。

/v1/apm2/openapi/cmdb/topology-trees/get-topology-trees?business_id=162

响应示例

状态码: 200

OK,请求响应成功。

{
  "topology_tree" : {
    "tree" : [ {
      "id" : "162-55-11",
      "parent" : "162-55",
      "real_id" : 11,
      "name" : "apm-pu-task",
      "display_name" : "apm-pu-task",
      "app_name" : null,
      "app_id" : null,
      "is_admin" : false,
      "is_root" : false,
      "business_id" : 162,
      "node_type" : "APPLICATION",
      "is_default" : false,
      "region" : null
    }, {
      "id" : "162-55",
      "parent" : "162",
      "real_id" : 55,
      "name" : "App",
      "display_name" : "App",
      "app_name" : null,
      "app_id" : null,
      "is_admin" : false,
      "is_root" : false,
      "business_id" : 162,
      "node_type" : "SUB_BUSINESS",
      "is_default" : false,
      "region" : null
    }, {
      "id" : "162",
      "parent" : null,
      "real_id" : 162,
      "name" : "LubanApm",
      "display_name" : "LubanApm",
      "app_name" : null,
      "app_id" : null,
      "is_admin" : false,
      "is_root" : true,
      "business_id" : 162,
      "node_type" : "BUSINESS",
      "is_default" : false,
      "region" : null
    }, {
      "id" : "162-55-11-11",
      "parent" : "162-55-11",
      "real_id" : 11,
      "name" : "xxx-roma-2",
      "display_name" : "xxx-roma-2",
      "app_name" : "apm-pu-task",
      "app_id" : 11,
      "is_admin" : false,
      "is_root" : false,
      "business_id" : 162,
      "node_type" : "ENVIRONMENT",
      "is_default" : false,
      "region" : "xxx-roma-2"
    } ]
  }
}

状态码

状态码

描述

200

OK,请求响应成功。

400

Bad Request,语义或参数有误。

401

Unauthorized,没有权限。

403

Forbidden,禁止访问。

404

Not Found,没有找到要请求的资源。

错误码

请参见错误码

相关文档