# 查询任务组信息 - ListTaskGroupHistory #### 功能介绍 查询项目下指定的功能自动化任务组信息 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v3/task-group/detail/history #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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位。 | 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | taskGroupId | 是 | String | 任务组id **获取方式** 从 POST /v3/task/list 返回结果中对应的id字段获取。 | | testServiceId | 是 | String | 服务id **获取方式** 从 GET /rest/me 返回结果中的 projectId 字段获取。 | | coldDataFlag | 否 | Boolean | 冷数据开关 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | result | [result] object | 返回结果 | | requestId | String | 请求ID | | serverIp | String | 服务IP | | status | String | 状态 | 表4result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | isSetResultToTMSS | Boolean | 是否给TMSS回填结果 | | completedTestcaseCount | Integer | 完成用例数量 | | simple | Boolean | 简单任务 | | dependId | String | 模板Id | | versionName | String | 版本名称 | | type | String | 类型 | | elapseTime | Integer | 历史执行时长记录单位是秒 | | totalTestcaseCount | Integer | 总用例数量 | | children | Array of [children] objects | 子任务对象 | | envInfo | [envInfo] object | 环境信息 | | startTime | Integer | 开始时间 | | state | Integer | 状态 | | id | String | ID | | blockedTestcaseCount | Integer | 分块用例数量 | | taskGroupExeParam | String | 任务组执行参数 | | tmssInfo | [tmssInfo] object | tmssI信息 | | productId | String | 租户ID | | author | String | 作者 | | investigatedTestcaseCount | Integer | 调查测试用例计数 | | testServiceId | String | 测试服务ID | | overTimeParam | [overTimeParam] object | 超时参数 | | remainTime | Integer | 剩余时间 | | priority | String | 策略 | | failedTestcaseCount | Integer | 失败测试用例数量 | | analyser | String | 分析人 | | taskStrategy | Object | 任务策略 | | versionId | String | 版本ID | | testEnvironment | String | 测试环境 | | stage | String | 阶段 | | createTime | Integer | 创建时间 | | passedTestcaseCount | Integer | 通过测试用例数量 | | name | String | 名称 | | progress | Integer | 进度 | | endTime | Integer | 结束时间 | | circle | [circle] object | 周期 | | unavailableTestcaseCount | Integer | 不可用测试用例数量 | | taskPolicy | Integer | 任务策略 1 表示直接执行 ，2 保存并运行，3 表示保存 ， | 表5children | 参数 | 参数类型 | 描述 | |:---|:---|:---| | taskMode | String | 任务模式 | | completedTestcaseCount | Integer | 完成用例数量 | | tmssVersion | String | tmss版本名称 | | type | String | 类型 | | elapseTime | Integer | 经过时间 | | platform | Array of [platform] objects | 平台 | | userExtendContent | [userExtendContent] object | 扩展内容 | | testbeds | Array of strings | 测试床 | | totalTestcaseCount | Integer | 总测试用例数量 | | startTime | Integer | 开始时间 | | state | Integer | 状态 | | id | String | ID | | blockedTestcaseCount | Integer | 分块测试用例数量 | | resource | [resource] object | 资源 | | investigatedTestcaseCount | Integer | 调查测试用例计数 | | author | String | 作者 | | remainTime | Integer | 剩余时间 | | failedTestcaseCount | Integer | 失败测试用例数量 | | taskStrategy | [taskStrategy] object | 任务策略 | | testEnvironment | String | 测试环境 | | needEnvVersion | Boolean | 是否需要环境版本 | | createTime | Integer | 创建时间 | | passedTestcaseCount | Integer | 通过测试用例 | | name | String | 名称 | | progress | Integer | 进度 | | location | String | 地点 | | endTime | Integer | 结束时间 | | unavailableTestcaseCount | Integer | 不可用用例数量 | | taskPolicy | Integer | 任务策略 | | resourceType | String | 资源类型 | | maxExecuteTime | Integer | 最大执行时间 | 表6platform | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ip | String | IP | | groupId | String | 分组ID | | tepmanagerId | String | 执行器管理ID | | id | String | ID | 表7userExtendContent | 参数 | 参数类型 | 描述 | |:---|:---|:---| | serviceType | String | 服务类型 | | platFromErrStrategy | String | 平台错误策略 | | ignoreEnv | Boolean | 是否忽略环境 | | Env_Network_Area | String | 环境网络区域 | | productName | String | 产品名称 | | scene | String | 场景 | | serial_execution | Boolean | 是否顺序执行 | | cloudTestType | String | 测试类型 | | jenkinsPassword | String | jenkins密码 | | exeParamTemplateId | String | 执行参数模板 | | git_url | String | git地址 | | envSystem | String | 环境系统 | | downloadScriptUrl | [downloadScriptUrl] object | 下载地址 | | branchId | String | 分支ID | | rgid | String | 区域ID | | releaseVersion | String | 发布版本 | | ip | String | ip | | jenkinsUsername | String | jenkins用户 | | branchName | String | 分支 | | exeParam | String | 执行参数 | | env | Array of strings | 环境 | | taskDesc | String | 任务描述 | | isSelectAllTeps | Boolean | 是否选择全部执行器 | | iteratorId | String | 版本Id | | iteratorName | String | 版本名称 | | jenkins_url | String | jenkins地址 | | exe_param_overridable | Boolean | 执行参数是否可以覆盖 | | excuteType | String | 执行类型 | | stage | String | 阶段 | | port | String | 端口 | | jenkinsIds | Array of strings | jenkinsID | | isGroupExeParam | String | 是否分组执行参数 | | isPersonConfig | String | 是否个人配置 | | region | String | 区域 | | git_username | String | git用户 | 表8downloadScriptUrl | 参数 | 参数类型 | 描述 | |:---|:---|:---| | api_host | String | 接口域名 | 表9resource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uris | Array of strings | 地址 | | type | String | 类型 | 表10taskStrategy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | isDistributeByLastTimeCost | Boolean | 是否按上次分配 | | caseExecType | Integer | 用例执行类型 | | checkEnvSwitch | Boolean | 是否检查环境开关 | | applyEnvFirst | Boolean | 是否首先应用环境 | | oneBlock | Boolean | 是否一个分块 | | parallelBatchSize | Integer | 并行批次大小 | | testCaseBlockReRunType | Integer | 执行器异常的时候，重新下发的策略 1重新下发未执行的用例 2全部重新下发执行（默认） 3不重新下发 | | blockSize | Integer | 分块大小 | 表11envInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | lcmurl | String | 环境服务地址 | | lcmurlvpc | String | 环境服务vpc地址 | 表12tmssInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | urlvpc | String | vpc地址 | | type | String | 类型 | | url | String | 地址 | 表13overTimeParam | 参数 | 参数类型 | 描述 | |:---|:---|:---| | stopType | Integer | 停止类型 | 表14circle | 参数 | 参数类型 | 描述 | |:---|:---|:---| | distance | Integer | 间隔 | | beginTime | Integer | 周期任务开始时间 | | concludingTime | Integer | 任务结束时间(单位：毫秒，表示时间戳，0表示任务是定时任务，无周期)（来自任务模板） | #### 请求示例 ``` post https:/{endpoint}/v3/task-group/detail/history?_=1756352012801 { "taskGroupId" : "6259853711715074048", "coldDataFlag" : false, "testServiceId" : "4b9bf03d8b7949799d5ceb76542dc380" } ``` #### 响应示例 **状态码：200** OK ``` { "result" : { "isSetResultToTMSS" : true, "completedTestcaseCount" : 1, "simple" : false, "dependId" : "2831111394147958784", "versionName" : "样例测试计划", "type" : "TiccTaskProject", "elapseTime" : 13914, "totalTestcaseCount" : 1, "children" : [ { "taskMode" : "2+1", "completedTestcaseCount" : 1, "tmssVersion" : "样例测试计划", "type" : "executing", "elapseTime" : 11028, "platform" : [ { "ip" : "10.90.2.121:30000", "groupId" : "10.90.2.121:30000", "tepmanagerId" : "", "id" : "10.90.2.121:30000" } ], "userExtendContent" : { "serviceType" : "Single", "platFromErrStrategy" : "no", "ignoreEnv" : false, "Env_Network_Area" : "networkArea", "productName" : "productName", "scene" : "", "serial_execution" : false, "cloudTestType" : "cloudTestType", "jenkinsPassword" : "", "exeParamTemplateId" : "bd696e399d8c497f9270940e7ccfccb3", "git_url" : "", "envSystem" : "", "downloadScriptUrl" : { "api_host" : "apigw.huawei.com" }, "branchId" : "v9050000tqu3e7e2", "rgid" : "", "releaseVersion" : "null-null", "ip" : "", "jenkinsUsername" : "", "branchName" : "基线", "exeParam" : "{\"\":\"\",\"executor\":\"efdb403066474ab08836b9eeaaa23bca\"}", "env" : [ ], "taskDesc" : "", "isSelectAllTeps" : false, "iteratorId" : "v9050000tqu3e7ev", "iteratorName" : "样例测试计划", "jenkins_url" : "", "exe_param_overridable" : false, "excuteType" : "17958", "stage" : "", "port" : "", "jenkinsIds" : [ ], "isGroupExeParam" : "true", "isPersonConfig" : "false", "region" : "cn-north-7", "git_username" : "" }, "testbeds" : [ ], "totalTestcaseCount" : 1, "startTime" : 1755672552255, "state" : 6, "id" : "2857293411704635393", "blockedTestcaseCount" : 0, "resource" : { "uris" : [ "v92t00010inlrleg" ], "type" : "TestCase" }, "investigatedTestcaseCount" : 0, "author" : "efdb403066474ab08836b9eeaaa23bca", "remainTime" : 0, "failedTestcaseCount" : 0, "taskStrategy" : { "isDistributeByLastTimeCost" : false, "caseExecType" : 2, "checkEnvSwitch" : true, "applyEnvFirst" : false, "oneBlock" : false, "parallelBatchSize" : 2500, "testCaseBlockReRunType" : 2, "blockSize" : 10 }, "testEnvironment" : "云化TICC", "needEnvVersion" : false, "createTime" : 1755672550293, "passedTestcaseCount" : 0, "name" : "1", "progress" : 100, "location" : "", "endTime" : 1755672563283, "unavailableTestcaseCount" : 1, "taskPolicy" : 3, "resourceType" : "TestCase", "maxExecuteTime" : 0 } ], "envInfo" : { "lcmurl" : "", "lcmurlvpc" : "" }, "startTime" : 1755672550357, "state" : 6, "id" : "2857293411704635392", "blockedTestcaseCount" : 0, "taskGroupExeParam" : "{\"isGroupExeParam\":false,\"exeParamTemplateId\":\"bd696e399d8c497f9270940e7ccfccb3\",\"exeParam\":\"{\\\"\\\":\\\"\\\"}\",\"region\":\"cn-north-7\"}", "tmssInfo" : { "urlvpc" : "", "type" : "CloudTMSS", "url" : "https://tmss-backend.cn-north-7.myhuaweicloud.com:8443" }, "productId" : "c2d63f9d3af34177ab62545d841c78d7", "author" : "efdb403066474ab08836b9eeaaa23bca", "investigatedTestcaseCount" : 0, "testServiceId" : "c2d63f9d3af34177ab62545d841c78d7", "overTimeParam" : { "stopType" : 0 }, "remainTime" : 0, "priority" : "", "failedTestcaseCount" : 0, "analyser" : "efdb403066474ab08836b9eeaaa23bca", "taskStrategy" : { }, "versionId" : "v9050000tqu3e7ev", "testEnvironment" : "云化TICC", "stage" : "", "createTime" : 1755672550270, "passedTestcaseCount" : 0, "name" : "grouptask", "progress" : 100, "endTime" : 1755672564271, "circle" : { "distance" : 0, "beginTime" : 0, "concludingTime" : 0 }, "unavailableTestcaseCount" : 1, "taskPolicy" : 3 }, "requestId" : "", "serverIp" : "", "status" : "ok" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。