执行用例调度任务接口 - CreateTasks
功能介绍
执行用例调度任务接口，创建一个任务
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/tasks
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 不涉及 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| cases | 否 | Array of strings | 用例列表 |
| functionType | 否 | String | 执行的功能类型："1"表示执行；"2"表示调试 |
| releaseversion | 否 | String | 发布版本号 |
| resourcePool | 否 | ResourcePool object | 资源池 |
| taskName | 否 | String | 任务名称 |
响应参数
状态码：200
OK
状态码：201
Created
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 |
| error_msg | String | 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 |
状态码：403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 |
| error_msg | String | 参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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
OK
{
"status" : "success",
"result" : {
"taskId" : "b98e483aecba4fe3b00b0fe484c391ca",
"needApprove" : null,
"warn" : [ ],
"packageType" : "codearts.testplan.china.pro",
"isPopup" : false
},
"error" : null
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 201 | Created |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
错误码
请参见错误码。
