# 分页查询执行器 - ShowTepDetails
#### 功能介绍
根据条件，分页查询功能自动化某租户下的执行器
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v3/hutaf-ticc/tm/teps/action/query
#### 请求参数
表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参数 
| 参数     | 是否必选 | 参数类型                                                                       | 描述        |
|:---|:---|:---|:---|
| where  | 否    | Array of [WhereParameter] objects | 查询过滤参数    |
| option | 否    | [PageParameterV3] object         | 查询排序和分页参数 |
   
 表3WhereParameter 
| 参数    | 是否必选 | 参数类型   | 描述              |
|:---|:---|:---|:---|
| key   | 否    | String | 查询字段名           |
| type  | 否    | String | 条件 =、\>、like、in |
| value | 否    | String | 查询条件值可以数组、数字、字符 |
   
 表4PageParameterV3 
| 参数          | 是否必选 | 参数类型    | 描述                             |
|:---|:---|:---|:---|
| 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                                                      | 总数   |
   
 表6result 
| 参数              | 参数类型    | 描述                     |
|:---|:---|:---|
| 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" : 285081055370831462428508105880680529932850810588068052998,
    "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"
  } ],
  "total" : "1"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | Success |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。