文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 功能自动化任务管理/ 查询任务组信息 - ListTaskGroupHistory
更新时间:2025-12-27 GMT+08:00
分享

查询任务组信息 - ListTaskGroupHistory

功能介绍

查询项目下指定的功能自动化任务组信息

调用方法

请参见如何调用API

URI

POST /v3/task-group/detail/history

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

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万。

默认取值:

不涉及。

requestId

String

参数解释

请求id

约束限制

不涉及

取值范围

字符串长度不少于1,不超过100000

默认取值

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

taskGroupId

String

任务组id

testServiceId

String

服务id

coldDataFlag

Boolean

冷数据开关

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

result

result object

返回结果

requestId

String

请求ID

serverIp

String

服务IP

status

String

状态

表4 result

参数

参数类型

描述

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 表示保存 ,

表5 children

参数

参数类型

描述

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

最大执行时间

表6 platform

参数

参数类型

描述

ip

String

IP

groupId

String

分组ID

tepmanagerId

String

执行器管理ID

id

String

ID

表7 userExtendContent

参数

参数类型

描述

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用户

表8 downloadScriptUrl

参数

参数类型

描述

api_host

String

接口域名

表9 resource

参数

参数类型

描述

uris

Array of strings

地址

type

String

类型

表10 taskStrategy

参数

参数类型

描述

isDistributeByLastTimeCost

Boolean

是否按上次分配

caseExecType

Integer

用例执行类型

checkEnvSwitch

Boolean

是否检查环境开关

applyEnvFirst

Boolean

是否首先应用环境

oneBlock

Boolean

是否一个分块

parallelBatchSize

Integer

并行批次大小

testCaseBlockReRunType

Integer

执行器异常的时候,重新下发的策略 1重新下发未执行的用例 2全部重新下发执行(默认) 3不重新下发

blockSize

Integer

分块大小

表11 envInfo

参数

参数类型

描述

lcmurl

String

环境服务地址

lcmurlvpc

String

环境服务vpc地址

表12 tmssInfo

参数

参数类型

描述

urlvpc

String

vpc地址

type

String

类型

url

String

地址

表13 overTimeParam

参数

参数类型

描述

stopType

Integer

停止类型

表14 circle

参数

参数类型

描述

distance

Integer

间隔

beginTime

Integer

周期任务开始时间

concludingTime

Integer

任务结束时间(单位:毫秒,表示时间戳,0表示任务是定时任务,无周期)(来自任务模板)

请求示例

post https:/{endpoint}/v3/task-group/detail/history?_=1756352012801

响应示例

状态码: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

错误码

请参见错误码

相关文档