文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 功能自动化任务管理/ 创建或执行任务组 - ExecuteTaskGroup
更新时间:2025-12-27 GMT+08:00
分享

创建或执行任务组 - ExecuteTaskGroup

功能介绍

根据taskPolicy,创建功能自动化任务组,或者直接提交执行自动化任务组

调用方法

请参见如何调用API

URI

POST /v3/task-group/execution

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

x-auth-groups

String

参数解释

用户权限组。通过调用IAM服务

约束限制

不涉及

取值范围

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

默认取值

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

branchId

String

分支ID

branchName

String

分支名称

versionId

String

版本ID

versionName

String

版本名称

id

String

唯一ID

author

String

作者ID

analyser

String

分析者ID

testServiceId

String

测试服务ID

userName

String

用户ID

taskGroupName

String

任务组名称

scheduledTime

String

定时调度时间

intervalTime

String

调度间隔时间

intervalTimeUnit

String

调度间隔时间单位

taskPolicy

Integer

任务策略

taskGroupExeParam

taskGroupExeParam object

任务组执行参数

taskStrategy

taskStrategy object

任务策略

circle

circle object

循环执行参数

overTimeParam

overTimeParam object

超时参数

tmssInfo

tmssInfo object

测试用例信息

tasks

Array of tasks objects

任务列表

表3 taskGroupExeParam

参数

是否必选

参数类型

描述

exeParam

String

执行参数

exeParamTemplateId

String

参数模板ID

表4 taskStrategy

参数

是否必选

参数类型

描述

extendParam

String

扩展参数

表5 circle

参数

是否必选

参数类型

描述

distance

Integer

循环间隔

beginTime

Integer

循环起始时间

concludingTime

Integer

循环结束时间

表6 overTimeParam

参数

是否必选

参数类型

描述

maxExecuteTime

Integer

最大执行时间

表7 tmssInfo

参数

是否必选

参数类型

描述

type

String

类型:"CloudTMSS" - CloudTMSS

url

String

访问地址

urlvpc

String

VPC地址

表8 tasks

参数

是否必选

参数类型

描述

id

String

任务ID

parentId

String

父任务组ID

taskName

String

任务名称

ticcTaskType

String

功能自动化任务类型:serial - 串行,parallel - 并行,executing - 执行中

maxTepNum

String

最大执行器数量

testServiceId

String

测试服务ID

strategyId

String

策略ID

executeType

String

执行类型

testType

String

测试类型:regression - 回归

startTime

String

启动时间

endTime

String

结束时间

intervalTime

String

间隔时间

Mail

String

邮箱

exeParam

String

执行参数

exeParamTemplateId

String

参数模板ID

envSystem

String

环境系统

envDetails

String

环境详情

resourceType

String

资源类型:"TestVersion" - 测试版本,"TestItem" - 测试项,"TaskFolder" - 任务目录,"TestCase" - 测试用例,"Task" - 任务,"UserDefined" - 用户定义

uris

Array of strings

用例uri列表

ip

String

IP地址

port

String

端口号

taskPolicy

String

任务策略

isPersonConfig

Boolean

是否个人配置

sutRepoUrl

String

SUT代码仓地址

gitUsername

String

git用户名

ignoreEnv

Boolean

忽略环境

needEnvVersion

Boolean

需要环境版本

rgId

String

区域

testbeds

Array of strings

测试床

location

String

位置

inputHost

String

输入主机

env

Array of strings

环境变量

teps

Array of teps objects

执行器数组

taskDesc

String

任务描述

selectedTeps

Array of strings

选中的执行器

pSelect

Array of strings

选择执行器

caseUris

Array of strings

用例URIs

taskUris

Array of strings

任务URIs

isGroupExeParam

Boolean

是否组执行参数

showPreCondition

String

展示前置条件

showTermination

String

展示终止条件

jenkinsUrl

String

Jenkins地址

jenkinsUsername

String

Jenkins用户名

jenkinsPassword

String

Jenkins密码

userextendParam

userextendParam object

用户扩展参数

exe_param_overridable

Boolean

执行参数可覆盖

user_init_sh

String

用户初始化脚本

user_finalized_sh

String

用户最终处理脚本

cpts_kpi_monitor

String

cpts kpi监控

serial_execution

Boolean

串行执行

taskStrategy

taskStrategy object

任务策略

author

String

任务创建人

analyser

String

任务分析人

jenkinsId

String

Jenkins任务ID

stageId

Integer

阶段ID

git_branch

String

git分支

circle

Object

循环信息

scene

String

场景

coverageServer

String

覆盖服务器

taskMode

String

任务模式

isSelectAllTeps

Boolean

是否全选执行器

downloadScriptUrl

String

下载脚本url

serviceName

String

服务名称

branchId

String

分支ID

branchName

String

分支名称

versionId

String

版本ID

versionName

String

版本名称

表9 teps

参数

是否必选

参数类型

描述

id

String

执行器id

groupId

String

执行器组id

表10 userextendParam

参数

是否必选

参数类型

描述

platFromErrStrategy

String

平台异常策略

表11 taskStrategy

参数

是否必选

参数类型

描述

blockSize

String

块大小

extendParam

String

扩展参数

响应参数

状态码:200

表12 响应Body参数

参数

参数类型

描述

result

result object

任务结果

requestId

String

请求唯一标识

serverIp

String

服务端IP

status

String

状态:ok - 成功

表13 result

参数

参数类型

描述

id

String

任务ID

状态码:201

Created

状态码:401

表14 响应Body参数

参数

参数类型

描述

status

String

请求状态:"failed" - 失败

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

状态码:403

表15 响应Body参数

参数

参数类型

描述

status

String

请求状态:"failed" - 失败

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

状态码:404

表16 响应Body参数

参数

参数类型

描述

status

String

请求状态:"failed" - 失败

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

请求示例

执行任务组

 post https://{endpoint}/v3/task-group/execution

{
  "versionId" : "v9050000tqu3e7e2",
  "versionName" : "用例库",
  "taskId" : "2549123529622683648",
  "author" : "efdb403066474ab08836b9eeaaa23bca",
  "analyser" : "efdb403066474ab08836b9eeaaa23bca",
  "ticcTaskType" : "TiccTaskProject",
  "testServiceId" : "c2d63f9d3af34177ab62545d841c78d7",
  "userName" : "efdb403066474ab08836b9eeaaa23bca",
  "taskGroupName" : "xxxxx",
  "intervalTime" : "0",
  "intervalTimeUnit" : "h",
  "taskPolicy" : 3,
  "taskGroupExeParam" : {
    "exeParam" : "",
    "exeParamTemplateId" : ""
  },
  "taskStrategy" : { },
  "circle" : {
    "distance" : 0,
    "beginTime" : 0,
    "concludingTime" : 0
  },
  "overTimeParam" : {
    "maxExecuteTime" : 0
  },
  "tmssInfo" : {
    "type" : "CloudTMSS",
    "url" : { },
    "urlvpc" : ""
  },
  "tasks" : [ {
    "id" : "2569626191665299456",
    "parentId" : "2549123529622683648",
    "taskName" : 1,
    "ticcTaskType" : "executing",
    "teps" : [ {
      "ip" : "10.10.10.10:3000",
      "groupId" : "10.10.10.10:3000",
      "tepmanagerId" : "",
      "id" : "10.10.10.10:3000"
    } ],
    "resourceType" : "TestCase",
    "testbeds" : [ ],
    "needEnvVersion" : false,
    "env" : [ ],
    "exe_param_overridable" : false,
    "isGroupExeParam" : "true",
    "taskPolicy" : 3,
    "location" : "",
    "maxExecuteTime" : 0,
    "taskMode" : "2+1",
    "priority" : "",
    "taskStrategy" : {
      "isDistributeByLastTimeCost" : false,
      "caseExecType" : 2,
      "checkEnvSwitch" : true,
      "applyEnvFirst" : false,
      "parallelSchedulerBlockFields" : "exeplatform,envType,mapRestrict",
      "oneBlock" : false,
      "parallelBatchSize" : 2500,
      "testCaseBlockReRunType" : 2,
      "blockSize" : 10
    },
    "rgId" : "",
    "uris" : [ "v92n00010cj7l81b" ],
    "caseUris" : [ "v92n00010cj7l81b" ],
    "pSelect" : [ "10.10.10.10:3000" ],
    "selectedTeps" : [ "10.10.10.10:3000" ],
    "serviceType" : "Single",
    "userextendParam" : {
      "platFromErrStrategy" : "no"
    },
    "pbiName" : "",
    "ignoreEnv" : false,
    "Env_Network_Area" : "networkArea",
    "productName" : "productName",
    "scene" : "",
    "testActivityType" : "",
    "serial_execution" : false,
    "jenkinsPassword" : "",
    "sutRepoUrl" : "",
    "envSystem" : "",
    "downloadScriptUrl" : "{\"downloadScriptUrl\":{\"api_host\":\"apigw.huawei.com\"}}",
    "rgid" : "",
    "ip" : "",
    "jenkinsUsername" : "",
    "pbiId" : "",
    "taskDesc" : "",
    "isSelectAllTeps" : false,
    "iteratorId" : "v9050000tqu3e7e2",
    "iteratorName" : "用例库",
    "jenkinsUrl" : "",
    "executeType" : "6",
    "port" : "",
    "jenkinsId" : "",
    "isPersonConfig" : false,
    "gitUsername" : "",
    "git_branch" : "",
    "testServiceId" : "c2d63f9d3af34177ab62545d841c78d7",
    "serviceName" : "deng_test",
    "exeParam" : "",
    "exeParamTemplateId" : "",
    "versionId" : "v9050000tqu3e7e2",
    "versionName" : "用例库"
  }, {
    "id" : "2569626191665299457",
    "parentId" : "2549123529622683648",
    "taskName" : "test_三方仓库_copy_16r",
    "ticcTaskType" : "executing",
    "teps" : [ {
      "ip" : "tep_agaent",
      "groupId" : "tep_agaent",
      "tepmanagerId" : "",
      "id" : "tep_agaent"
    }, {
      "ip" : "hello_ticc_test_agent",
      "groupId" : "hello_ticc_test_agent",
      "tepmanagerId" : "",
      "id" : "hello_ticc_test_agent"
    }, {
      "ip" : "10.10.10.10:3000",
      "groupId" : "10.10.10.10:3000",
      "tepmanagerId" : "",
      "id" : "10.10.10.10:3000"
    } ],
    "resourceType" : "TestCase",
    "testbeds" : [ ],
    "needEnvVersion" : false,
    "env" : [ ],
    "exe_param_overridable" : false,
    "isGroupExeParam" : "true",
    "taskPolicy" : 3,
    "location" : "",
    "maxExecuteTime" : 0,
    "taskMode" : "2+1",
    "priority" : "",
    "taskStrategy" : {
      "isDistributeByLastTimeCost" : false,
      "caseExecType" : 2,
      "checkEnvSwitch" : true,
      "applyEnvFirst" : false,
      "parallelSchedulerBlockFields" : "exeplatform,envType,mapRestrict",
      "oneBlock" : false,
      "parallelBatchSize" : 2500,
      "testCaseBlockReRunType" : 2,
      "blockSize" : 10
    },
    "rgId" : "",
    "uris" : [ "v92n000109d66hls", "v92t00010975ks7s" ],
    "caseUris" : [ "v92n000109d66hls", "v92t00010975ks7s" ],
    "pSelect" : [ "tep_agaent", "hello_ticc_test_agent", "10.10.10.10:3000" ],
    "selectedTeps" : [ "tep_agaent", "hello_ticc_test_agent", "10.10.10.10:3000" ],
    "serviceType" : "Single",
    "userextendParam" : {
      "platFromErrStrategy" : "no"
    },
    "pbiName" : "",
    "ignoreEnv" : false,
    "Env_Network_Area" : "networkArea",
    "productName" : "productName",
    "scene" : "",
    "testActivityType" : "",
    "serial_execution" : false,
    "jenkinsPassword" : "",
    "gitPassword" : "",
    "sutRepoUrl" : "1231231122",
    "envSystem" : "",
    "downloadScriptUrl" : "{\"downloadScriptUrl\":{\"api_host\":\"apigw.huawei.com\"}}",
    "rgid" : "",
    "ip" : "",
    "jenkinsUsername" : "",
    "git_branch" : "123123111222",
    "pbiId" : "",
    "taskDesc" : "",
    "isSelectAllTeps" : false,
    "iteratorId" : "v9050000tqu3e7e2",
    "iteratorName" : "用例库",
    "jenkinsUrl" : "",
    "executeType" : "6",
    "port" : "",
    "jenkinsId" : "",
    "isPersonConfig" : true,
    "gitUsername" : "",
    "testServiceId" : "c2d63f9d3af34177ab62545d841c78d7",
    "serviceName" : "deng_test",
    "exeParam" : "",
    "exeParamTemplateId" : "",
    "versionId" : "v9050000tqu3e7e2",
    "versionName" : "用例库"
  } ]
}

响应示例

状态码:200

OK

{
  "result" : {
    "id" : "2549123529622683648"
  },
  "requestId" : "",
  "serverIp" : "",
  "status" : "ok"
}

状态码:401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档