文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 功能自动化任务管理/ 执行任务模板, 执行多个模板时，其中一个执行失败则返回失败
更新时间：2025-06-26 GMT+08:00
在线调试
CLI示例
查看PDF
分享

执行任务模板, 执行多个模板时，其中一个执行失败则返回失败

功能介绍

执行任务组

调用方法

请参见如何调用API。

URI

POST /attask/v3/taskmodel/execution

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

必传。

取值范围：

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

默认取值：

不涉及。
表2 请求Body参数

参数

是否必选

参数类型

描述

port

否

String

端口

testSuite

否

Array of testSuite objects

测试套件列表

sut_branch_name

否

String

SUT分支名

sutName

否

String

SUT名称

userName

否

String

用户名

testServiceId

否

String

测试服务ID
表3 testSuite

参数

是否必选

参数类型

描述

taskId

否

String

任务ID

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

ip

String

服务IP地址

port

String

服务端口号

test_suite

Array of test_suite objects

测试套件列表

sut_branch_name

String

测试SUT分支名

sut_name

String

SUT名称

user_name

String

用户名称或用户ID

test_service_id

String

测试服务ID
表5 test_suite

参数

参数类型

描述

task_id

String

任务ID

状态码：201

Created

状态码：401

表6 响应Body参数

参数

参数类型

描述

status

String

请求状态

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

状态码：403

表7 响应Body参数

参数

参数类型

描述

status

String

请求状态

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

状态码：404

表8 响应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}/attask/v3/taskmodel/execution

{
  "ip" : "",
  "port" : "",
  "testSuite" : [ {
    "taskId" : "2587542699280171008"
  } ],
  "sut_branch_name" : "基线",
  "sutName" : "deng_test",
  "userName" : "efdb403066474ab08836b9eeaaa23bca",
  "testServiceId" : "c2d63f9d3af34177ab62545d841c78d7"
}

响应示例

状态码：200

OK

{
  "result" : "46bf29d06a4c4cc3ac9ebd896e5812b4",
  "requestId" : "",
  "serverIp" : "",
  "status" : "ok"
}

状态码：401

Unauthorized

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

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

相关文档