分页查询执行器 - 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
}