流水线插件,返回查表信息 - QueryResourceTableDataTotalForUser
功能介绍
流水线插件，返回查表信息（可限定修改时间）,只返回总数, 项目uuid 必传。调用此接口前必须联系技术人员添加账号白名单并获取关键调用参数，否则无法调用。
调用方法
请参见如何调用API。
URI
POST /testreport/v4/user/etl/query/data-total
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
value | 详细结果 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
状态码：401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
状态码：404
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
状态码：500
参数 | 参数类型 | 描述 |
|---|---|---|
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
{
"status" : "success",
"result" : {
"total" : 2
}
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
404 | Not Found |
500 | Internal Server Error |
错误码
请参见错误码。
