文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 功能自动化任务管理/ 查询任务用例执行信息 - ListTcInfoByCondition
更新时间：2025-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询任务用例执行信息 - ListTcInfoByCondition

功能介绍

根据条件，查询功能自动化任务的用例执行信息

调用方法

请参见如何调用API。

URI

POST /v3/hutaf-ticc/tm/task-objs/tcinfo

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

x-auth-tenantid

是

String

参数解释

CLOUD_TEST租户

约束限制

不涉及

取值范围

字符串长度不少于1，不超过100000

默认取值

不涉及

x-auth-groups

是

String

参数解释

项目id

约束限制

不涉及

取值范围

字符串长度不少于1，不超过100000

默认取值

不涉及

x-user-name

是

String

参数解释

用户名

约束限制

不涉及

取值范围

字符串长度不少于1，不超过100000

默认取值

不涉及

x-auth-token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

必传。

取值范围：

字符串长度不少于1，不超过10万。

默认取值：

不涉及。
表2 请求Body参数

参数

是否必选

参数类型

描述

taskId

否

String

任务ID

realTaskId

否

String

真实任务ID

groupMsg

否

groupMsg object

分组信息

where

否

Array of WhereParameter objects

查询过滤参数

option

否

PageParameterV3 object

查询排序和分页参数
表3 groupMsg

参数

是否必选

参数类型

描述

isGroupItem

否

Boolean

是否分组对象

groupType

否

String

分组类型
表4 WhereParameter

参数

是否必选

参数类型

描述

key

否

String

查询字段名

type

否

String

条件 =、>、like、in

value

否

String

查询条件值可以数组、数字、字符
表5 PageParameterV3

参数

是否必选

参数类型

描述

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

状态
表7 result

参数

参数类型

描述

summarys

Array of summarys objects

汇总信息

resultSize

resultSize object

数量
表8 summarys

参数

参数类型

描述

blocked

Integer

分块ID

failed

Integer

字段

investigated

Integer

调查数量

name

String

名称

notExecuted

Integer

没执行的数量

passed

Integer

通过的数量

totalExecuteTime

Integer

一共执行的时间

totalNum

Integer

总数量

unavailable

Integer

不可用
表9 resultSize

参数

参数类型

描述

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

返回结果
表14 error_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" : "result",
    "type" : "in",
    "value" : [ -2, 6, 5, 4, 3, 2, 1, 0 ]
  }, {
    "key" : "ticcTepid",
    "type" : "like",
    "value" : ""
  } ],
  "option" : {
    "limit" : 10,
    "start" : 0,
    "order" : "asc",
    "by" : "starttime"
  }
}

响应示例

状态码：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

错误码

请参见错误码。

相关文档