# 流水线插件,返回查表信息 - QueryResourceTableDataTotalForUser
#### 功能介绍
流水线插件，返回查表信息（可限定修改时间）,只返回总数, 项目uuid 必传。调用此接口前必须联系技术人员添加账号白名单并获取关键调用参数，否则无法调用。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /testreport/v4/user/etl/query/data-total
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                              |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表2请求Body参数 
| 参数                | 是否必选 | 参数类型             | 描述                                                    |
|:---|:---|:---|:---|
| table_name        | 是    | String           | 需要同步的表名称                                              |
| is_bak            | 否    | Boolean          | 是否是bak表数据                                             |
| start_time        | 否    | String           | 查询时间段起始时间                                             |
| end_time          | 否    | String           | 查询时间段截止时间                                             |
| filter_time_field | 否    | String           | 时间段过滤的字段                                              |
| sort_field        | 否    | String           | 用于时间排序的字段，不传默认按照更新时间排序                                |
| offset            | 是    | Integer          | 分页偏移量                                                 |
| limit             | 是    | Integer          | 分页大小，最大值1000                                          |
| schema_no         | 否    | String           | 分库编号（数字类型                                             |
| project_uuid      | 是    | String           | 项目id                                                  |
| query_fields      | 否    | Array of strings | 查询的资源, 查询的字段会影响单次查询最大的条数,查询字段内容占用的内存越多，接口支持的条数越小, 可为空 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数    | 参数类型                                                                                                                | 描述   |
|:---|:---|:---|
| value | [TestHubExternalPageVoForEtlVo] object | 详细结果 |
   
 表4TestHubExternalPageVoForEtlVo 
| 参数     | 参数类型             | 描述             |
|:---|:---|:---|
| total  | Long             | 总数             |
| values | Array of objects | 返回的数据JSONArray |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码  |
| error_msg  | String | 接口调用失败错误信息 |
   
**状态码：401**
表6响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码  |
| error_msg  | String | 接口调用失败错误信息 |
   
**状态码：404**
表7响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码  |
| error_msg  | String | 接口调用失败错误信息 |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码  |
| error_msg  | String | 接口调用失败错误信息 |
   
#### 请求示例
```
post https://{endpoint}/testreport/v4/user/etl/query/data-total
{
  "table_name" : "relation",
  "is_bak" : false,
  "sort_field" : "CREATIONDATE",
  "offset" : 0,
  "limit" : 50,
  "filter_time_field" : "CREATIONDATE",
  "start_time" : "2025-09-12 15:00:00",
  "end_time" : "2025-09-12 15:10:00",
  "project_uuid" : "f78b8dcce91f4664b813d5c029733942",
  "schema_no" : "3",
  "query_fields" : [ "TESTCASEURI" ]
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : {
    "total" : 10
  }
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。