创建任务
功能介绍
创建任务
调用方法
请参见如何调用API。
URI
POST /v3/task/execution
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
x-auth-groups |
是 |
String |
参数解释 用户权限组。通过调用IAM服务 约束限制 不涉及 取值范围 字符串长度不少于1,不超过100000 默认取值 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
taskName |
否 |
String |
任务名称 |
executeType |
否 |
String |
执行类型 |
testType |
否 |
String |
测试类型 |
exeParam |
否 |
String |
执行参数 |
exe_param_overridable |
否 |
Boolean |
执行参数是否可重写 |
envSystem |
否 |
String |
环境字段 |
envDetails |
否 |
String |
环境详情 |
resourceType |
否 |
String |
资源类型 |
uris |
否 |
Array of strings |
资源uri列表 |
ip |
否 |
String |
ip |
port |
否 |
String |
端口 |
taskPolicy |
否 |
Integer |
任务策略 |
isPersonConfig |
否 |
Boolean |
是否个人配置 |
sutRepoUrl |
否 |
String |
代码仓库地址 |
gitUsername |
否 |
String |
git用户名 |
git_branch |
否 |
String |
git分支 |
ignoreEnv |
否 |
Boolean |
是否忽略环境 |
needEnvVersion |
否 |
Boolean |
是否需要环境版本 |
rgId |
否 |
String |
区域ID |
testbeds |
否 |
Array of strings |
测试床 |
maxTepNum |
否 |
String |
最大执行器数 |
inputHost |
否 |
String |
host |
env |
否 |
Array of strings |
环境 |
teps |
否 |
Array of teps objects |
执行机对象数组 |
location |
否 |
String |
执行机ID |
userextendParam |
否 |
userextendParam object |
扩展参数 |
testActivityType |
否 |
String |
测试激活类型 |
branchId |
否 |
String |
分支Id |
versionName |
否 |
String |
版本名称 |
versionId |
否 |
String |
版本Id |
testServiceId |
否 |
String |
测试服务人员 |
maillist |
否 |
String |
邮件列表 |
priority |
否 |
String |
优先级 |
taskStrategy |
否 |
taskStrategy object |
任务策略 |
circle |
否 |
circle object |
循环执行 |
author |
否 |
String |
作者 |
analyser |
否 |
String |
分析人 |
jenkinsId |
否 |
String |
jenkinsId |
isSelectAllTeps |
否 |
Boolean |
是否选择全部执行机 |
pSelect |
否 |
Array of strings |
选择的执行机 |
selectedTeps |
否 |
Array of strings |
选择的执行机 |
caseUris |
否 |
Array of strings |
用例数组 |
downloadScriptUrl |
否 |
String |
下载脚本地址 |
taskType |
否 |
String |
任务类型 |
taskId |
否 |
String |
任务id |
childrenId |
否 |
String |
子任务Id |
pbiName |
否 |
String |
PBI名称 |
pbiId |
否 |
String |
PBI的ID |
tmssInfo |
否 |
tmssInfo object |
测试用例信息 |
taskMode |
否 |
String |
任务模型 |
taskTyle |
否 |
String |
任务类型 template 表示模板;task 表示任务 |
serial_execution |
否 |
Boolean |
是否顺序执行 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
parallelRerunCount |
否 |
String |
并行返回数量 |
parallelFailedRerunCount |
否 |
String |
并行失败返回数量 |
parallelBatchSize |
否 |
Integer |
并行批量大小 |
blockSize |
否 |
Integer |
块大小 |
serialOrderField |
否 |
String |
序列号排序字段 |
caseExecType |
否 |
Integer |
用例执行类型 |
extendParam |
否 |
String |
扩展参数 |
applyEnvFirst |
否 |
Boolean |
使用的第一个环境 |
parallelSchedulerBlockFields |
否 |
String |
并行调度器块字段 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
task_name |
String |
任务名称 |
execute_type |
String |
执行类型 |
test_type |
String |
测试类型 |
exe_param |
String |
执行参数 |
exe_param_overridable |
Boolean |
执行参数是否可覆写 |
env_system |
String |
环境系统 |
env_details |
String |
环境详情 |
resource_type |
String |
资源类型 |
uris |
Array of strings |
用例库URIs |
ip |
String |
测试IP地址 |
port |
String |
测试端口 |
task_policy |
Integer |
任务策略编号 |
is_person_config |
Boolean |
是否是个人配置 |
sut_repo_url |
String |
SUT仓库URL |
git_username |
String |
Git用户名 |
git_branch |
String |
Git分支名 |
ignore_env |
Boolean |
是否忽略环境 |
need_env_version |
Boolean |
是否需要环境版本 |
rg_id |
String |
区域ID |
testbeds |
Array of strings |
测试床列表 |
max_tep_num |
String |
最大执行机数 |
input_host |
String |
输入主机 |
env |
Array of strings |
运行环境配置 |
teps |
Array of teps objects |
T执行机实例列表 |
location |
String |
任务位置 |
userextend_param |
userextend_param object |
用户扩展参数 |
test_activity_type |
String |
测试活动类型 |
branch_id |
String |
迭代/分支ID |
version_name |
String |
版本名称 |
version_id |
String |
版本ID |
test_service_id |
String |
测试服务ID |
maillist |
String |
邮件列表 |
priority |
String |
优先级 |
task_strategy |
task_strategy object |
任务策略配置 |
circle |
circle object |
任务循环相关参数 |
author |
String |
创建人(用户ID) |
analyser |
String |
分析人员(用户ID) |
jenkins_id |
String |
Jenkins唯一标识 |
is_select_all_teps |
Boolean |
是否全选执行机 |
p_select |
Array of strings |
选中的执行机列表 |
selected_teps |
Array of strings |
实际选中的执行机列表 |
case_uris |
Array of strings |
用例URIs |
download_script_url |
String |
下载脚本URL(JSON字符串) |
task_type |
String |
任务类型 |
task_id |
String |
任务ID |
children_id |
String |
子任务ID |
pbi_name |
String |
PBI名称 |
pbi_id |
String |
PBI唯一标识 |
tmss_info |
tmss_info object |
用例管理服务 |
task_mode |
String |
任务模式 |
task_tyle |
String |
任务类型(字段名可能为Type拼写) |
serial_execution |
Boolean |
是否串行执行 |
参数 |
参数类型 |
描述 |
---|---|---|
parallel_rerun_count |
String |
并行重试次数 |
parallel_failed_rerun_count |
String |
并行失败重试次数 |
parallel_batch_size |
Integer |
并行批次大小 |
block_size |
Integer |
每批次用例数 |
serial_order_field |
String |
串行顺序字段 |
case_exec_type |
Integer |
用例执行类型 |
extend_param |
String |
扩展参数 |
apply_env_first |
Boolean |
是否优先申请环境 |
parallel_scheduler_block_fields |
String |
并行调度阻断字段 |
参数 |
参数类型 |
描述 |
---|---|---|
start_time |
String |
循环开始时间 |
interval_time_unit |
String |
循环间隔单位 |
end_time |
String |
结束时间 |
time_type |
String |
循环时间类型 |
interval_time |
String |
循环间隔数值 |
状态码:201
Created
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
请求状态 |
request_id |
String |
请求id |
server_ip |
String |
服务节点IP |
error_msg |
String |
错误信息 |
error_code |
String |
错误码 |
error_cause |
String |
错误原因 |
faq |
String |
faq内容 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
请求状态 |
request_id |
String |
请求id |
server_ip |
String |
服务节点IP |
error_msg |
String |
错误信息 |
error_code |
String |
错误码 |
error_cause |
String |
错误原因 |
faq |
String |
faq内容 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
请求状态 |
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/execution
{
"taskName" : "xxxx",
"executeType" : "6",
"testType" : "regression",
"exeParam" : "",
"exe_param_overridable" : false,
"envSystem" : "",
"envDetails" : "",
"resourceType" : "TestCase",
"uris" : [ "v92n10g2nkgf0v3j" ],
"ip" : "",
"port" : "",
"taskPolicy" : 3,
"isPersonConfig" : false,
"sutRepoUrl" : "",
"gitUsername" : "",
"git_branch" : "",
"ignoreEnv" : false,
"needEnvVersion" : false,
"rgId" : "",
"testbeds" : [ ],
"maxTepNum" : "",
"inputHost" : "",
"env" : [ ],
"teps" : [ {
"id" : "tep_agaent",
"groupId" : "tep_agaent"
} ],
"location" : "",
"userextendParam" : {
"platFromErrStrategy" : "no"
},
"testActivityType" : "",
"branchId" : "v9050000tqu3e7e2",
"versionName" : "用例库",
"versionId" : "v9050000tqu3e7e2",
"testServiceId" : "c2d63f9d3af34177ab62545d841c78d7",
"maillist" : "",
"priority" : "",
"taskStrategy" : {
"parallelRerunCount" : "",
"parallelFailedRerunCount" : "",
"parallelBatchSize" : 2500,
"blockSize" : 9,
"serialOrderField" : null,
"caseExecType" : 2,
"extendParam" : null,
"applyEnvFirst" : false,
"parallelSchedulerBlockFields" : "exeplatform,envType,mapRestrict"
},
"circle" : {
"startTime" : "",
"intervalTimeUnit" : "h",
"endTime" : "",
"timeType" : "0",
"intervalTime" : "0"
},
"author" : "efdb403066474ab08836b9eeaaa23bca",
"analyser" : "efdb403066474ab08836b9eeaaa23bca",
"jenkinsId" : "",
"isSelectAllTeps" : false,
"pSelect" : [ "tep_agaent" ],
"selectedTeps" : [ "tep_agaent" ],
"caseUris" : [ "v92n10g2nkgf0v3j" ],
"downloadScriptUrl" : "{\"downloadScriptUrl\":{\"api_host\":\"apigw.huawei.com\"}}",
"taskType" : "task",
"taskId" : "2587542699280171008",
"childrenId" : "2587542699280171008",
"pbiName" : "",
"pbiId" : "",
"tmssInfo" : {
"type" : "CloudTMSS",
"url" : {
"url" : null
},
"urlvpc" : ""
},
"taskMode" : "2+1",
"taskTyle" : "task",
"serial_execution" : false
}
响应示例
状态码:200
OK
{
"result" : {
"id" : "2587542699280171008"
},
"requestId" : "",
"serverIp" : "",
"status" : "OK"
}
状态码:401
Unauthorized
{
"error_code" : "DEV.00000003",
"error_msg" : "认证信息过期"
}
状态码
状态码 |
描述 |
---|---|
200 |
OK |
201 |
Created |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
错误码
请参见错误码。