# 获取链路追踪概览表格数据（V2） - ShowSkywalkingMetricOverviewAnalysisTable
#### 功能介绍
获取链路追踪概览表格数据。
#### 调用方法
请参见[如何调用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::getConf | Read | -           | -   | - apm:apm2BusinessView:get  - apm:apm2Service:get   | -      |
     
  
 
#### URI
POST /v2/view/sw/metric/get-overview-analysis-table
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token  | 是    | String | 从IAM服务获取的用户Token。 |
| x-business-id | 是    | Long   | 应用id              |
   
表2请求Body参数 
| 参数         | 是否必选 | 参数类型   | 描述           |
|:---|:---|:---|:---|
| env_id     | 是    | Long   | 环境id。        |
| key        | 是    | String | 指标项。         |
| start_time | 是    | String | 开始时间，毫秒级时间戳。 |
| end_time   | 是    | String | 结束时间，毫秒级时间戳。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型                                                                                                                                                   | 描述 |
|:---|:---|:---|
| \[数组元素\] | Array of [SumTableResponse_OverviewAnalysisTable] objects | -  |
   
 表4SumTableResponse_OverviewAnalysisTable 
| 参数               | 参数类型                                                                                                                                   | 描述                                                                                                                                                                                                                   |
|:---|:---|:---|
| row_list         | Array of [FrontRow_OverviewAnalysisTable] objects | 数据行列表。                                                                                                                                                                                                               |
| latest_data_Time | Long                                                                                                                                   | 最近一笔数据的时间。                                                                                                                                                                                                           |
| table_direction  | String                                                                                                                                 | 表格的方向，H：表头横向，V：表头纵向。 枚举值： H V |
| real_start_time  | Long                                                                                                                                   | 实际开始的时间。                                                                                                                                                                                                             |
| real_end_time    | Long                                                                                                                                   | 实际结束的时间。                                                                                                                                                                                                             |
| notice_msg       | String                                                                                                                                 | 提示信息。                                                                                                                                                                                                                |
| total_count      | Integer                                                                                                                                | 总数。                                                                                                                                                                                                                  |
   
 表5FrontRow_OverviewAnalysisTable 
| 参数        | 参数类型                                                                                                                           | 描述                    |
|:---|:---|:---|
| header    | Boolean                                                                                                                        | 是否是header信息。          |
| cell_list | [FrontCell_OverviewAnalysisTable] object | 数据单元集合。               |
| filter    | String                                                                                                                         | 将group by的字段拼接成过滤字符串。 |
   
 表6FrontCell_OverviewAnalysisTable 
| 参数        | 参数类型    | 描述     |
|:---|:---|:---|
| trace     | Boolean | 是否调用链。 |
| data_type | String  | 数据类型。  |
| function  | String  | 函数。    |
| text      | String  | 文本信息。  |
| visible   | Boolean | 是否可见。  |
   
#### 请求示例
```
/v2/view/sw/metric/get-overview-analysis-table
{
  "env_id" : "1628824",
  "start_time" : 1767668581861,
  "end_time" : 1767754981861,
  "key" : "$collectorCategory.swSlowInvoking$"
}
```
响应示例
**状态码：200**
OK
```
{
  "row_list" : [ {
    "header" : true,
    "cell_list" : [ {
      "trace" : false,
      "data_type" : "ENUM",
      "function" : "",
      "text" : "url",
      "visible" : true
    }, {
      "data_type" : "INT",
      "function" : "MAX(maxTime) as=最大耗时(ms) isTrace=false",
      "text" : "最大耗时(ms)",
      "visible" : true
    }, {
      "data_type" : "DOUBLE",
      "function" : "SUM(totalTime)/SUM(invokeCount) as=平均耗时(ms) isTrace=false",
      "text" : "平均耗时(ms)",
      "visible" : true
    }, {
      "data_type" : "INT",
      "function" : "SUM(slowCount) as=慢调用次数 isTrace=false",
      "text" : "慢调用次数",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "POST /user/login",
      "visible" : true
    }, {
      "text" : "133394",
      "visible" : true
    }, {
      "text" : "131362.16",
      "visible" : true
    }, {
      "text" : "1392",
      "visible" : true
    } ],
    "filter" : "url=POST /user/login"
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "POST /user/validate",
      "visible" : true
    }, {
      "text" : "132455",
      "visible" : true
    }, {
      "text" : "130361.11",
      "visible" : true
    }, {
      "text" : "1719",
      "visible" : true
    } ],
    "filter" : "url=POST /user/validate"
  } ],
  "latest_data_Time" : 0,
  "table_direction" : "H",
  "real_start_time" : 1767682331634,
  "real_end_time" : 1767768731634,
  "total_count" : 2
}
```
#### 状态码
| 状态码 | 描述                 |
|:---|:---|
| 200 | OK。                |
| 400 | Bad Request。       |
| 403 | Forbidden。         |
| 429 | Too Many Requests。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。