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

分页查询执行器 - ShowTepDetails

功能介绍

根据条件，分页查询功能自动化某租户下的执行器

调用方法

请参见如何调用API。

URI

POST /v3/hutaf-ticc/tm/teps/action/query

请求参数

表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参数

参数

是否必选

参数类型

描述

where

否

Array of WhereParameter objects

查询过滤参数

option

否

PageParameterV3 object

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

参数

是否必选

参数类型

描述

key

否

String

查询字段名

type

否

String

条件 =、>、like、in

value

否

String

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

参数

是否必选

参数类型

描述

order_by

否

String

排序字段

order_sort

否

String

排序顺序，asc：升序；desc：降序

order_limit

否

Integer

分页：接口一次返回的结果数量

order_start

否

Integer

分页：从第start+1条数据开始，最多返回limit条数据

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

status

String

状态

result

Array of result objects

返回结果

total

String

总数
表6 result

参数

参数类型

描述

id

String

执行器ID

name

String

执行器名

url

String

执行器的URL

productId

String

产品ID

projectId

String

项目ID

version

String

设备版本

type

String

执行器类型

status

String

状态

ip

String

IP

lastRelease

String

上一次占用执行器的任务及用例块信息

share

Integer

执行器是否可以共享

extendParameter

String

扩展参数

createTime

String

创建时间

group

String

执行器分组KEY

network

String

网络

insType

Integer

是否为容器化执行器，0非共享，1共享，默认0

property

String

属性

registerCodeId

String

注册码ID

tenantShare

Integer

执行器租户间是否共享

sendtcType

String

sendtc到执行器类型，push/pull

请求示例

https://{endpoint}/v3/hutaf-ticc/tm/teps/action/query

{
  "where" : [ {
    "key" : "name",
    "type" : "in",
    "value" : [ "hello_ticc_test_agent" ]
  }, {
    "key" : "project_id",
    "type" : "=",
    "value" : "337b4500889c4570811c5fe7c0d5dd25"
  } ],
  "option" : {
    "order_by" : "create_time",
    "order_sort" : "desc",
    "order_limit" : "15",
    "order_start" : "0"
  }
}

响应示例

状态码：200

Success

{
  "status" : "ok",
  "result" : [ {
    "id" : "2209327535772858880",
    "name" : "test_joe03",
    "url" : "http://localhost:40033",
    "productId" : "e1f57b377b7c43c088058b94d9595f9f",
    "projectId" : "b0c12b48f98e4eb49af333c4dc08b6e5",
    "version" : "205",
    "type" : "Ticc_System_Type",
    "status" : "idle",
    "ip" : "test_joe03",
    "lastRelease" : "2850810553708314624_2850810588068052993_2850810588068052998",
    "share" : 0,
    "extendParameter" : "{\"name\":\"joes\"}",
    "createTime" : "2025-08-13T02:25:37.000+00:00",
    "group" : "cn-north-7",
    "network" : "general",
    "insType" : 0,
    "property" : "using",
    "registerCodeId" : "2542779691127799808",
    "tenantShare" : 0,
    "sendtcType" : "pull"
  }, {
    "id" : "2209326642419661312",
    "name" : "test_joe02",
    "url" : "http://localhost:40022",
    "productId" : "e1f57b377b7c43c088058b94d9595f9f",
    "projectId" : "b0c12b48f98e4eb49af333c4dc08b6e5",
    "version" : "203",
    "type" : "Ticc_System_Type",
    "status" : "idle",
    "ip" : "test_joe02",
    "lastRelease" : "2850810553708314624_2850810588068052993_2850810588068052997",
    "share" : 0,
    "extendParameter" : "{\"name\":\"joe\"}",
    "createTime" : "2025-08-13T02:25:12.000+00:00",
    "group" : "cn-north-7",
    "network" : "general",
    "insType" : 0,
    "property" : "using",
    "registerCodeId" : "2542779691127799808",
    "tenantShare" : 0,
    "sendtcType" : "pull"
  } ],
  "total" : "2",
  "statusOK" : true
}

状态码

状态码

描述

200

Success

错误码

请参见错误码。

相关文档