# 第三方异步查询增删改资源,返回查表信息（可限定修改时间）,只返回总数 - AsyncListResourceTableDataTotal
#### 功能介绍
此接口用于查询增删改资源,返回查表信息，根据入参的时间范围、项目ID和模式编号，实现按条件筛选的数据总量统计查询功能。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### 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})获取此次请求的最终处理结果   |
   
 表3ExternalPageVoForEtlJSONArray 
| 参数     | 参数类型   | 描述    |
|:---|:---|:---|
| 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
```
{
  "is_async_operate" : true,
  "async_uri" : "v80h000110a2umtc"
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。