# 查询URL跟踪视图详情 - SearchTransaction
#### 功能介绍
查询某条URL跟踪视图详情。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-apm/apm_04_0007.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-apm/apm_04_0021.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                            | 访问级别 | 资源类型（\*为必须） | 条件键                   | 别名                           | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | apm:application:getTransaction | Read | -           | g:EnterpriseProjectId | apm:apm2BusinessBusiness:get | -      |
     
  
 
#### URI
POST /v1/apm2/openapi/transaction/detail
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token  | 是    | String | 从IAM服务获取的用户Token。 |
| x-business-id | 是    | Long   | 应用id。             |
   
 表2请求Body参数 
| 参数         | 是否必选 | 参数类型   | 描述         |
|:---|:---|:---|:---|
| tx_name    | 是    | String | 事务名称。      |
| start_time | 是    | String | 开始时间的毫秒级戳。 |
| end_time   | 是    | String | 结束时间的毫秒级戳。 |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数           | 参数类型                                                               | 描述           |
|:---|:---|:---|
| tx_node_list | Array of [TxNode] objects | 组件节点列表。      |
| tx_line_list | Array of [TxLine] objects | 组件之间调用指向线列表。 |
   
 表4TxNode 
| 参数           | 参数类型   | 描述                                                 |
|:---|:---|:---|
| tx_node_id   | String | 节点id。                                              |
| tx_node_name | String | 节点名称。                                              |
| tx_node_type | String | 节点类型。如user、HttpClient(网络节点)、env(环境)、Mysql(数据库节点)等。 |
| tx_env_id    | Long   | 环境节点id。                                            |
   
 表5TxLine 
| 参数           | 参数类型   | 描述                                                   |
|:---|:---|:---|
| tx_from_node | String | 开始节点。                                                |
| tx_to_node   | String | 结束节点。                                                |
| invoke_count | Long   | 调用次数。                                                |
| rt           | Double | 组件间调用耗时，单位毫秒(ms)。                                    |
| error_count  | Long   | 错误数。                                                 |
| type         | String | 目标节点类型。如user、HttpClient(网络节点)、env(环境)、Mysql(数据库节点)等。 |
| direction    | String | 指向。                                                  |
   
#### 请求示例
查询事务名称为3，开始时间戳为1667456607000，结束时间戳为1667457807000的URL跟踪视图详情。
```
/v1/apm2/openapi/transaction/detail
{
  "start_time" : 1667456607000,
  "end_time" : 1667457807000,
  "tx_name" : "3"
}
```
#### 响应示例
**状态码： 200**
OK，请求响应成功。
```
{
  "tx_node_list" : [ {
    "tx_node_id" : "48",
    "tx_node_name" : "apm-api:xx-xxxx-xxx-az1",
    "tx_node_type" : "env",
    "tx_env_id" : 48
  }, {
    "tx_node_id" : "11.108.243.78:3306:apm2_cmdb",
    "tx_node_name" : "11.108.243.78:3306:apm2_cmdb",
    "tx_node_type" : "Mysql",
    "tx_env_id" : null
  }, {
    "tx_node_id" : "user",
    "tx_node_name" : "user",
    "tx_node_type" : "user",
    "tx_env_id" : null
  }, {
    "tx_node_id" : "295",
    "tx_node_name" : "lubanops-api:xx-xxxx-xxx",
    "tx_node_type" : "env",
    "tx_env_id" : 295
  }, {
    "tx_node_id" : "11.108.242.168:3306:apm2_region",
    "tx_node_name" : "11.108.242.168:3306:apm2_region",
    "tx_node_type" : "Mysql",
    "tx_env_id" : null
  }, {
    "tx_node_id" : "54",
    "tx_node_name" : "apm-front:xx-xxxx-xxx",
    "tx_node_type" : "env",
    "tx_env_id" : 54
  }, {
    "tx_node_id" : "Elasticsearch:11.108.246.171:9200,11.108.246.24:9200,11.108.246.47:9200",
    "tx_node_name" : "Elasticsearch:11.108.246.171:9200,11.108.246.24:9200,11.108.246.47:9200",
    "tx_node_type" : "EsRestClient",
    "tx_env_id" : null
  } ],
  "tx_line_list" : [ {
    "tx_from_node" : "54",
    "tx_to_node" : "48",
    "invoke_count" : 364,
    "rt" : 28.065934065934066,
    "error_count" : 0,
    "type" : "HttpClient",
    "direction" : "out"
  }, {
    "tx_from_node" : "48",
    "tx_to_node" : "Elasticsearch:11.108.246.171:9200,11.108.246.24:9200,11.108.246.47:9200",
    "invoke_count" : 359,
    "rt" : 18.08635097493036,
    "error_count" : 0,
    "type" : "EsRestClient",
    "direction" : "out"
  }, {
    "tx_from_node" : "295",
    "tx_to_node" : "54",
    "invoke_count" : 365,
    "rt" : 49.87123287671233,
    "error_count" : 0,
    "type" : "HttpClient",
    "direction" : "out"
  }, {
    "tx_from_node" : "54",
    "tx_to_node" : "11.108.242.168:3306:apm2_region",
    "invoke_count" : 48,
    "rt" : 2.3541666666666665,
    "error_count" : 0,
    "type" : "Mysql",
    "direction" : "out"
  }, {
    "tx_from_node" : "54",
    "tx_to_node" : "48",
    "invoke_count" : 359,
    "rt" : 19.220055710306408,
    "error_count" : 0,
    "type" : "Url",
    "direction" : "in"
  }, {
    "tx_from_node" : "user",
    "tx_to_node" : "295",
    "invoke_count" : 365,
    "rt" : 50.92876712328767,
    "error_count" : 0,
    "type" : "Url",
    "direction" : "in"
  }, {
    "tx_from_node" : "295",
    "tx_to_node" : "54",
    "invoke_count" : 364,
    "rt" : 29.354395604395606,
    "error_count" : 0,
    "type" : "Url",
    "direction" : "in"
  }, {
    "tx_from_node" : "295",
    "tx_to_node" : "11.108.243.78:3306:apm2_cmdb",
    "invoke_count" : 58,
    "rt" : 0.5862068965517241,
    "error_count" : 0,
    "type" : "Mysql",
    "direction" : "out"
  } ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK，请求响应成功。            |
| 400 | Bad Request，语义或参数有误。  |
| 401 | Unauthorized，没有权限。    |
| 403 | Forbidden，禁止访问。       |
| 404 | Not Found，没有找到要请求的资源。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。