# 查询任务用例执行信息 - ListTcInfoByCondition
#### 功能介绍
根据条件，查询功能自动化任务的用例执行信息
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v3/hutaf-ticc/tm/task-objs/tcinfo
#### 请求参数
表1请求Header参数 
| 参数              | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| x-auth-tenantid | 是    | String | **参数解释** 租户id **约束限制** 不涉及 **取值范围** 字符串长度不少于1，不超过100000 **默认取值** 不涉及 **获取方式** 从 GET /rest/me 的返回结果中对应的id字段获取。 |
| x-auth-groups   | 是    | String | **参数解释** 项目id **约束限制** 不涉及 **取值范围** 字符串长度不少于1，不超过100000 **默认取值** 不涉及 **获取方式** 从 GET /rest/me 的返回结果中对应的id字段获取。 |
| x-user-name     | 是    | String | **参数解释** 用户id **约束限制** 不涉及 **取值范围** 字符串长度不少于1，不超过100000 **默认取值** 不涉及 **获取方式** 从 GET /rest/me 的返回结果中对应的id字段获取。 |
| x-auth-token    | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。        |
   
表2请求Body参数 
| 参数         | 是否必选 | 参数类型                                                                              | 描述                                                                                                                                     |
|:---|:---|:---|:---|
| taskId     | 否    | String                                                                            | 任务ID **获取方式** 从 POST /v3/task/list 返回结果中对应的id字段获取。   |
| realTaskId | 否    | String                                                                            | 真实任务ID **获取方式** 从 POST /v3/task/list 返回结果中对应的id字段获取。 |
| groupMsg   | 否    | [groupMsg] object                       | 分组信息                                                                                                                                   |
| where      | 否    | Array of [WhereParameter] objects | 查询过滤参数                                                                                                                                 |
| option     | 否    | [PageParameterV3] object         | 查询排序和分页参数                                                                                                                              |
   
 表3groupMsg 
| 参数          | 是否必选 | 参数类型    | 描述     |
|:---|:---|:---|:---|
| isGroupItem | 否    | Boolean | 是否分组对象 |
| groupType   | 否    | String  | 分组类型   |
   
 表4WhereParameter 
| 参数    | 是否必选 | 参数类型   | 描述              |
|:---|:---|:---|:---|
| key   | 否    | String | 查询字段名           |
| type  | 否    | String | 条件 =、\>、like、in |
| value | 否    | String | 查询条件值可以数组、数字、字符 |
   
 表5PageParameterV3 
| 参数          | 是否必选 | 参数类型    | 描述                             |
|:---|:---|:---|:---|
| order_by    | 否    | String  | 排序字段                           |
| order_sort  | 否    | String  | 排序顺序，asc：升序；desc：降序            |
| order_limit | 否    | Integer | 分页：接口一次返回的结果数量                 |
| order_start | 否    | Integer | 分页：从第start+1条数据开始，最多返回limit条数据 |
   
#### 响应参数
**状态码：200**
表6响应Body参数 
| 参数     | 参数类型                                                     | 描述   |
|:---|:---|:---|
| result | [result] object | 返回结果 |
| status | String                                                   | 状态   |
   
 表7result 
| 参数         | 参数类型                                                                   | 描述   |
|:---|:---|:---|
| summarys   | Array of [summarys] objects | 汇总信息 |
| resultSize | [resultSize] object       | 数量   |
   
 表8summarys 
| 参数               | 参数类型    | 描述      |
|:---|:---|:---|
| blocked          | Integer | 分块ID    |
| failed           | Integer | 字段      |
| investigated     | Integer | 调查数量    |
| name             | String  | 名称      |
| notExecuted      | Integer | 没执行的数量  |
| passed           | Integer | 通过的数量   |
| totalExecuteTime | Integer | 一共执行的时间 |
| totalNum         | Integer | 总数量     |
| unavailable      | Integer | 不可用     |
   
 表9resultSize 
| 参数   | 参数类型    | 描述 |
|:---|:---|:---|
| size | Integer | 数量 |
   
**状态码：201**
Created
**状态码：401**
表10响应Body参数 
| 参数          | 参数类型   | 描述                 |
|:---|:---|:---|
| status      | String | 请求状态："failed" - 失败 |
| request_id  | String | 请求id               |
| server_ip   | String | 服务节点IP             |
| error_msg   | String | 错误信息               |
| error_code  | String | 错误码                |
| error_cause | String | 错误原因               |
| faq         | String | faq内容              |
   
**状态码：403**
表11响应Body参数 
| 参数          | 参数类型   | 描述                 |
|:---|:---|:---|
| status      | String | 请求状态："failed" - 失败 |
| request_id  | String | 请求id               |
| server_ip   | String | 服务节点IP             |
| error_msg   | String | 错误信息               |
| error_code  | String | 错误码                |
| error_cause | String | 错误原因               |
| faq         | String | faq内容              |
   
**状态码：404**
表12响应Body参数 
| 参数          | 参数类型   | 描述                 |
|:---|:---|:---|
| status      | String | 请求状态："failed" - 失败 |
| request_id  | String | 请求id               |
| server_ip   | String | 服务节点IP             |
| error_msg   | String | 错误信息               |
| error_code  | String | 错误码                |
| error_cause | String | 错误原因               |
| faq         | String | faq内容              |
   
**状态码：default**
表13响应Body参数 
| 参数     | 参数类型                                                                                   | 描述   |
|:---|:---|:---|
| status | String                                                                                 | 请求状态 |
| result | [error_response_reason] object | 返回结果 |
   
 表14error_response_reason 
| 参数     | 参数类型   | 描述   |
|:---|:---|:---|
| reason | String | 失败理由 |
   
#### 请求示例
```
https://{endpoint}/v3/hutaf-ticc/tm/task-objs/tcinfo?_=1755510444613
{
  "taskId" : "2233212810802233344",
  "realTaskId" : "2233212810802233344",
  "groupMsg" : {
    "isGroupItem" : false,
    "groupType" : "ticcTepid"
  },
  "where" : [ {
    "key" : "author",
    "type" : "=",
    "value" : "s00485699"
  } ],
  "option" : {
    "order_by" : "create_time",
    "order_sort" : "desc",
    "order_limit" : 10,
    "order_start" : 0
  }
}
```
#### 响应示例
**状态码：200**
Success
```
{
  "result" : {
    "summarys" : [ {
      "blocked" : 0,
      "failed" : 1,
      "investigated" : 0,
      "name" : "10.91.60.140:3000",
      "notExecuted" : 0,
      "passed" : 0,
      "totalExecuteTime" : 0,
      "totalNum" : 1,
      "unavailable" : 0
    } ],
    "resultSize" : {
      "size" : 1
    }
  },
  "status" : "o"
}
```
**状态码：401**
Unauthorized
```
{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}
```
#### 状态码
| 状态码     | 描述               |
|:---|:---|
| 200     | Success          |
| 201     | Created          |
| 401     | Unauthorized     |
| 403     | Forbidden        |
| 404     | Not Found        |
| default | Unexpected error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。