获取应用树- 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
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
x-business-id |
是 |
Long |
应用id。 |
|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
topology_tree |
TopologyTree object |
拓扑树信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
节点类型。 枚举值:
|
|
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,没有找到要请求的资源。 |
错误码
请参见错误码。