创建或执行任务组 - ExecuteTaskGroup
功能介绍
根据taskPolicy,创建功能自动化任务组,或者直接提交执行自动化任务组
调用方法
请参见如何调用API。
URI
POST /v3/task-group/execution
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
|
x-auth-groups |
否 |
String |
参数解释 用户权限组。通过调用IAM服务 约束限制 不涉及 取值范围 字符串长度不少于1,不超过100000 默认取值 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
任务列表 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
distance |
否 |
Integer |
循环间隔 |
|
beginTime |
否 |
Integer |
循环起始时间 |
|
concludingTime |
否 |
Integer |
循环结束时间 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
type |
否 |
String |
类型:"CloudTMSS" - CloudTMSS |
|
url |
否 |
String |
访问地址 |
|
urlvpc |
否 |
String |
VPC地址 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
间隔时间 |
|
|
否 |
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 |
版本名称 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
result object |
任务结果 |
|
requestId |
String |
请求唯一标识 |
|
serverIp |
String |
服务端IP |
|
status |
String |
状态:ok - 成功 |
状态码:201
Created
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
请求状态:"failed" - 失败 |
|
request_id |
String |
请求id |
|
server_ip |
String |
服务节点IP |
|
error_msg |
String |
错误信息 |
|
error_code |
String |
错误码 |
|
error_cause |
String |
错误原因 |
|
faq |
String |
faq内容 |
状态码:403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
请求状态:"failed" - 失败 |
|
request_id |
String |
请求id |
|
server_ip |
String |
服务节点IP |
|
error_msg |
String |
错误信息 |
|
error_code |
String |
错误码 |
|
error_cause |
String |
错误原因 |
|
faq |
String |
faq内容 |
状态码:404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。