创建任务
功能介绍
创建任务
调用方法
请参见如何调用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 |
错误码
请参见错误码。
