
# 获取链路追踪原始数据表格（V2） - ShowSkywalkingMetricRawTable
#### 功能介绍
获取链路追踪原始数据表格。
#### 调用方法
请参见[如何调用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/raw-table
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token  | 是    | String | 从IAM服务获取的用户Token。 |
| x-business-id | 是    | Long   | 应用id。             |
   
表2请求Body参数 
| 参数              | 是否必选 | 参数类型                                                                       | 描述          |
|:---|:---|:---|:---|
| lastRowId       | 否    | String                                                                     | 上一次扫描的数据ID。 |
| instance_id     | 否    | Long                                                                       | 实例id。       |
| monitor_item_id | 否    | Long                                                                       | 监控项id。      |
| env_id          | 是    | Long                                                                       | 环境id。       |
| start_time      | 是    | String                                                                     | 开始时间。       |
| end_time        | 是    | String                                                                     | 结束时间。       |
| page            | 是    | Integer                                                                    | 当前页码。       |
| page_size       | 是    | Integer                                                                    | 每页数据总数。     |
| order_by        | 否    | String                                                                     | 排序。         |
| search_word     | 否    | String                                                                     | 搜索关键字。      |
| view_config     | 是    | [RawTableView] object | 原始数据表格视图。   |
   
 表3RawTableView 
| 参数              | 是否必选 | 参数类型                                                                           | 描述                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| span            | 是    | Boolean                                                                        | 跨度。                                                                                                                                                                                                                                |
| latest          | 否    | Boolean                                                                        | 是否只展示最近一笔数据。                                                                                                                                                                                                                       |
| collector_name  | 是    | String                                                                         | 采集器名称。                                                                                                                                                                                                                             |
| metric_set      | 是    | String                                                                         | 视图对应的指标集的名称。                                                                                                                                                                                                                       |
| title           | 是    | String                                                                         | 图标所需展示的标题。                                                                                                                                                                                                                         |
| table_direction | 是    | String                                                                         | 表格的方向，H：默认，表头横向，V：表头纵向。 枚举值： H V                                                   |
| group_by        | 是    | String                                                                         | 分组规则。                                                                                                                                                                                                                              |
| filter          | 是    | String                                                                         | 过滤列表模型。                                                                                                                                                                                                                            |
| field_item_list | 是    | Array of [FieldItem] objects | 所需展示的字段列表模型集合。                                                                                                                                                                                                                     |
| span_field      | 是    | String                                                                         | 跨度字段。                                                                                                                                                                                                                              |
| order_by        | 否    | String                                                                         | 排序规则。                                                                                                                                                                                                                              |
| view_type       | 否    | String                                                                         | 视图类型。 枚举值： trend sumtable rawtable |
   
 表4FieldItem 
| 参数            | 是否必选 | 参数类型    | 描述        |
|:---|:---|:---|:---|
| trace         | 否    | Boolean | 是否是trace。 |
| function      | 是    | String  | 表达式。      |
| as            | 否    | String  | 名称。       |
| default_value | 否    | String  | 默认值。      |
| precision     | 否    | Integer | 百分比。      |
| unit          | 否    | String  | 单位。       |
| visible       | 否    | Boolean | 是否可见。     |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数               | 参数类型                                                                                                        | 描述                                                                                                                                                                               |
|:---|:---|:---|
| row_list         | Array of [FrontRow_MetricRawTable] objects | 数据行。                                                                                                                                                                             |
| latest_data_Time | String                                                                                                      | 最近一笔数据的时间。                                                                                                                                                                       |
| table_direction  | String                                                                                                      | 表格的方向，H：默认，表头横向，V：表头纵向。 枚举值： H V |
| result_id        | String                                                                                                      | 上次请求id。                                                                                                                                                                          |
| real_start_time  | Long                                                                                                        | 实际开始的时间，主要用于下一次调用，特别是分页调用的时候传的参数。                                                                                                                                                |
| real_end_time    | Long                                                                                                        | 实际结束的时间。                                                                                                                                                                         |
   
 表6FrontRow_MetricRawTable 
| 参数        | 参数类型                                                                                                          | 描述           |
|:---|:---|:---|
| header    | Boolean                                                                                                       | 是否是header信息。 |
| cell_list | Array of [FrontCell_MetricRawTable] objects | 数据单元集合。      |
   
 表7FrontCell_MetricRawTable 
| 参数        | 参数类型    | 描述    |
|:---|:---|:---|
| data_type | String  | 数据类型。 |
| text      | String  | 文本信息。 |
| visible   | Boolean | 是否可见。 |
   
#### 请求示例
```
/v2/view/sw/metric/raw-table
{
    "end_time": 1767693439207,
    "env_id": "1628821",
    "page": 1,
    "page_size": 10,
    "start_time": 1767607039207,
    "view_config": {
        "span": true,
        "collector_name": "swRpcClient",
        "metric_set": "swRpcServer.url",
…}
```
响应示例
**状态码：200**
OK
```
{
  "row_list" : [ {
    "header" : true,
    "cell_list" : [ {
      "data_type" : "STRING",
      "text" : "time",
      "visible" : true
    }, {
      "data_type" : "STRING",
      "text" : "慢调用链",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:57:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104338.17676934251230149",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:56:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.99630.17676933758288639",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:55:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104188.17676933224000749",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:54:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.87790.17676932757205043",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:53:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104249.17676932227420495",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:52:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.98012.17676931757535135",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:51:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.98012.17676930755035133",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:50:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104249.17676930220680491",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:49:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104188.17676929753950743",
      "visible" : true
    } ]
  }, {
    "header" : false,
    "cell_list" : [ {
      "text" : "2026-01-06 17:48:00",
      "visible" : true
    }, {
      "text" : "923334aa137f4242bb6bb9015502616f.104339.17676929223060133",
      "visible" : true
    } ]
  } ],
  "latest_data_Time" : "2026-01-06 17:57:19",
  "table_direction" : "H",
  "real_start_time" : 1767607039207,
  "real_end_time" : 1767693439207
}
```
#### 状态码
| 状态码 | 描述                 |
|:---|:---|
| 200 | OK。                |
| 400 | Bad Request。       |
| 403 | Forbidden。         |
| 429 | Too Many Requests。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。
