文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 对外接口管理/ 第三方异步查询增删改资源,返回查表信息(可限定修改时间),只返回总数 - AsyncListResourceTableDataTotal
更新时间:2026-07-07 GMT+08:00
分享

第三方异步查询增删改资源,返回查表信息(可限定修改时间),只返回总数 - AsyncListResourceTableDataTotal

功能介绍

此接口用于查询增删改资源,返回查表信息,根据入参的时间范围、项目ID和模式编号,实现按条件筛选的数据总量统计查询功能。

调用方法

请参见如何调用API

URI

POST /v4/testhub/etl/async/query/data-total

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

schema_no

String

分库编号(数字类型), 0 - 10

table_name

String

查询的记录数据库表名称,小写

is_bak

Boolean

是否是bak表数据

start_time

String

查询时间段起始时间

end_time

String

查询时间段截止时间

filter_time_field

String

用于时间段过滤的字段

limit

Integer

分页大小,最大值1000

last_record_uri

String

上一次查询的最后一条记录的uri, 默认为null

query_fields

Array of strings

查询的资源, 查询的字段会影响单次查询最大的条数,查询字段内容占用的内存越多,接口支持的条数越小, 可为空

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

is_async_operate

Boolean

是否异步.固定为true:需要在调异步进度接口(/v4/testhub/progress/{operation_uri})获取此次请求的最终处理结果

async_uri

String

异步进度uri,需要在调异步进度接口(/v4/testhub/progress/{operation_uri}获取此次请求的最终处理结果

return_value

ExternalPageVoForEtlJSONArray object

请求返回的数据,需要调用异步解读接口(/testreport/v4/progress/etl/{async_uri})获取此次请求的最终处理结果

表3 ExternalPageVoForEtlJSONArray

参数

参数类型

描述

total

Long

总数量

values

Object

返回的数据

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/testhub/etl/async/query/data-total

{
  "table_name" : "task",
  "schema_no" : "1",
  "start_time" : "2022-08-06 09:37:25",
  "end_time" : "2026-08-06 09:37:26",
  "filter_time_field" : "LASTMODIFIED"
}

响应示例

状态码:200

OK

{
  "status" : "success",
  "is_async_operate" : true,
  "async_uri" : "v80h000110a2umtc"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档