文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 功能自动化任务管理/ 创建任务

更新时间：2025-07-24 GMT+08:00

在线调试

CLI示例

查看PDF

创建任务

功能介绍

创建任务

调用方法

请参见如何调用API。

URI

POST /v3/task/execution

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：字符串长度不少于1，不超过10万。默认取值：不涉及。
x-auth-groups	是	String	参数解释用户权限组。通过调用IAM服务约束限制不涉及取值范围字符串长度不少于1，不超过100000 默认取值不涉及

表2 请求Body参数
参数	是否必选	参数类型	描述
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	是否顺序执行

表3 teps
参数	是否必选	参数类型	描述
id	否	String	执行机ID
groupId	否	String	执行机分组

表4 userextendParam
参数	是否必选	参数类型	描述
platFromErrStrategy	否	String	平台错误处理策略

表5 taskStrategy
参数	是否必选	参数类型	描述
parallelRerunCount	否	String	并行返回数量
parallelFailedRerunCount	否	String	并行失败返回数量
parallelBatchSize	否	Integer	并行批量大小
blockSize	否	Integer	块大小
serialOrderField	否	String	序列号排序字段
caseExecType	否	Integer	用例执行类型
extendParam	否	String	扩展参数
applyEnvFirst	否	Boolean	使用的第一个环境
parallelSchedulerBlockFields	否	String	并行调度器块字段

表6 circle
参数	是否必选	参数类型	描述
startTime	否	String	开始时间
intervalTimeUnit	否	String	间隔时间
endTime	否	String	结束时间
timeType	否	String	时间单位
intervalTime	否	String	间隔时间

表7 tmssInfo
参数	是否必选	参数类型	描述
type	否	String	类型
url	否	String	访问地址
urlvpc	否	String	VPC地址

响应参数

状态码：200

表8 响应Body参数
参数	参数类型	描述
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	是否串行执行

表9 teps
参数	参数类型	描述
id	String	执行机主键
group_id	String	执行机分组ID

**表10** userextend_param
参数	参数类型	描述
plat_from_err_strategy	String	平台错误策略

**表11** task_strategy
参数	参数类型	描述
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	并行调度阻断字段

**表12** circle
参数	参数类型	描述
start_time	String	循环开始时间
interval_time_unit	String	循环间隔单位
end_time	String	结束时间
time_type	String	循环时间类型
interval_time	String	循环间隔数值

**表13** tmss_info
参数	参数类型	描述
type	String	用例管理服务类型
url	String	用例管理服务地址
urlvpc	String	VPC地址

状态码：201

Created

状态码：401

**表14** 响应Body参数
参数	参数类型	描述
status	String	请求状态
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	请求状态
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	请求状态
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,
    "caseExecType" : 2,
    "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" : { },
    "urlvpc" : ""
  },
  "taskMode" : "2+1",
  "taskTyle" : "task",
  "serial_execution" : false
}

响应示例

状态码：200

{
  "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

错误码

请参见错误码。

父主题： 功能自动化任务管理

上一篇：查询任务或者任务组详情

下一篇：执行任务组

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

创建任务

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？