# 查询关注的任务或任务模板 - ListFavoritesTask #### 功能介绍 根据查询参数，查询关注的功能自动化任务或者任务模板 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /attask/v1/task/query/favorites 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | type | 是 | String | 任务或者模板字段 | #### 请求参数 表2请求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万。 **默认取值：** 不涉及。 | | requestId | 是 | String | **参数解释** 请求id **约束限制** 不涉及 **取值范围** 字符串长度不少于1，不超过100000 **默认取值** 不涉及 **获取方式** 任意字母加数字组成的字符串，长度不超过32位。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | where | 否 | Array of [WhereParameter] objects | 查询过滤参数 | | option | 否 | [PageParameterV3] object | 查询排序和分页参数 | | service_id | 否 | String | **参数解释** 服务id **约束限制** 不涉及 **取值范围** 字符串长度不少于1，不超过100000 **默认取值** 不涉及 **获取方式** 从 GET /rest/me 返回结果中的 projectId 字段获取。 | 表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 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | Array of [data] objects | 返回数据对象 | | resultSize | [resultSize] object | 结果数 | 表8data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | isSetResultToTMSS | Boolean | 是否传结果给TMSS | | simple | Boolean | 是否简单 | | type | String | 类型 | | versionName | String | 版本名称 | | userExtendContent | [userExtendContent] object | 用户扩展内容 | | favoriteUser | String | 关注用户 | | envInfo | Object | 环境信息 | | state | Integer | 状态 | | id | String | ID | | tmssInfo | Object | TMSS信息 | | productId | String | 项目ID | | author | String | 作者 | | testServiceId | String | 测试服务ID | | verName | String | tmss版本名称 | | updateTime | Integer | 更新时间 | | overTimeParam | [overTimeParam] object | 超时参数 | | analyser | String | 分析者 | | versionId | String | 版本ID | | stage | String | 阶段 | | createTime | Integer | 创建时间 | | name | String | 名称 | | progress | Integer | 进度 | | maillist | String | 收件人 | | projectId | String | 项目ID | 表9userExtendContent | 参数 | 参数类型 | 描述 | |:---|:---|:---| | exeParamTemplateId | String | 执行参数模板ID | | exeParam | String | 执行参数 | 表10overTimeParam | 参数 | 参数类型 | 描述 | |:---|:---|:---| | stopType | String | 停止类型 | 表11resultSize | 参数 | 参数类型 | 描述 | |:---|:---|:---| | size | String | 数量 | #### 请求示例 ``` https:/{endpoint}/attask/v1/task/query/favorites?_=1756352012801 { "where" : [ { "key" : "author", "type" : "=", "value" : "s00485699" } ], "option" : { "order_by" : "create_time", "order_sort" : "desc", "order_limit" : 10, "order_start" : 0 }, "service_id" : "string" } ``` #### 响应示例 **状态码：200** Success ``` { "result" : { "data" : [ { "isSetResultToTMSS" : false, "simple" : false, "type" : "ticctaskproject", "versionName" : "基线", "userExtendContent" : { "exeParamTemplateId" : "", "exeParam" : "" }, "favoriteUser" : "efdb403066474ab08836b9eeaaa23bca", "envInfo" : { }, "state" : -1, "id" : "2842592082248335360", "tmssInfo" : { }, "productId" : "7b90e408636344328e44bf70bbae8351", "author" : "efdb403066474ab08836b9eeaaa23bca", "testServiceId" : "", "verName" : "基线", "updateTime" : 1755244685482, "overTimeParam" : { "stopType" : "" }, "analyser" : "efdb403066474ab08836b9eeaaa23bca", "versionId" : "v92u000107k90tfa", "stage" : "", "createTime" : 1755244685482, "name" : "grouptaskbbq2_copy_20250815155802", "progress" : 0, "maillist" : "", "projectId" : "2842592082248335360" } ], "resultSize" : { "size" : "12" } }, "status" : "ok" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | Success | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。