执行用例调度任务接口 - CreateTasks

功能介绍

执行用例调度任务接口，创建一个任务

调用方法

URI

POST /v1/{project_id}/tasks

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 不涉及取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值: 不涉及

请求参数

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

表3 请求Body参数
参数	是否必选	参数类型	描述
cases	否	Array of strings	用例列表
functionType	否	String	执行的功能类型："1"表示执行；"2"表示调试
releaseversion	否	String	发布版本号
resourcePool	否	ResourcePool object	资源池
taskName	否	String	任务名称

表4 ResourcePool
参数	是否必选	参数类型	描述
activeState	否	String	活动状态
id	否	String	唯一标识
name	否	String	名称
selected	否	Boolean	是否被选中
type	否	String	类型 VM docker

响应参数

状态码：200

状态码：201

Created

状态码：401

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：403

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：404

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

请求示例

{
  "cases" : [ "v92u000107pd4i0e" ],
  "taskName" : "taskTestSuite2025/3/10 10:00:49",
  "releaseversion" : "",
  "resourcePool" : {
    "activeState" : "ACTIVE",
    "id" : "DEFAULT",
    "type" : "DEFAULT"
  },
  "functionType" : "2"
}

响应示例

状态码：200

{
  "status" : "success",
  "result" : {
    "taskId" : "b98e483aecba4fe3b00b0fe484c391ca",
    "needApprove" : null,
    "warn" : [ ],
    "packageType" : "codearts.testplan.china.pro",
    "isPopup" : false
  },
  "error" : null
}