新增测试套任务 - AddTask
功能介绍
此接口用于新增测试套任务，同页面 测试 -> 测试执行 -> 右侧上方筛选分支，点击新建套件
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/tasks
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 字符串类型，长度32位字符 取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| uri | 否 | String | 参数解释 指定创建任务的uri 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| name | 是 | String | 参数解释 名称 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| stage | 否 | String | 参数解释 测试阶段 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| number | 否 | String | 参数解释 编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| tags | 否 | String | 参数解释 标记id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| description | 否 | String | 参数解释 描述 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| region | 否 | String | 参数解释 区域 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| version_uri | 否 | String | 参数解释 分支/迭代uri 约束限制 不涉及 取值范围 11-34位字母/数字 默认取值 不涉及 |
| owner_id | 否 | String | 参数解释 处理人/责任人id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| parent_uri | 否 | String | 参数解释 父任务uri 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| test_case_condition | 否 | String | 参数解释 动态任务用例过滤条件 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| service_type | 否 | Integer | 参数解释 服务类型 约束限制 不涉及 取值范围 0:功能测试 1:接口测试 11:性能测试 默认取值 不涉及 |
| module_id | 否 | String | 参数解释 模块id 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| module_name | 否 | String | 参数解释 模块名称 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| release_dev | 否 | String | 参数解释 发布版本号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| status_code | 否 | Integer | 参数解释 状态code 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| ext_param | 否 | String | 参数解释 扩展参数 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| execute_way | 否 | Integer | 参数解释 执行方式 约束限制 不涉及 取值范围 1：串行，2：并行 默认取值 不涉及 |
| execute_type | 否 | Integer | 参数解释 执行类型 约束限制 不涉及 取值范围 （0：冒烟，1：定时） 默认取值 不涉及 |
| plan_start_timestamp | 否 | Long | 参数解释 计划开始时间戳， 约束限制 不涉及 取值范围 当传入-1时，时间置为空 默认取值 不涉及 |
| plan_end_timestamp | 否 | Long | 参数解释 计划结束时间戳 约束限制 不涉及 取值范围 当传入-1时，时间置为空 默认取值 不涉及 |
| assign_case_uris | 否 | Array of strings | 参数解释 任务关联用例uri数组，CloudDragon环境 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| case_operation_info | 否 | CaseOperationInfo object | 参数解释 用例操作信息 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| only_update_status | 否 | Boolean | 参数解释 是否只需要修改测试套状态 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
| is_async | 否 | Boolean | 参数解释 是否异步 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
| changes | 否 | Array of ResourceChangeInfo objects | 参数解释 自定义字段的更新记录 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| empty | 否 | Boolean | 参数解释 是否为空 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
| test_cases_info | 否 | Array of AssignCaseInfo objects | 参数解释 用例关联信息 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| set_up_cases_info | 否 | Array of AssignCaseInfo objects | 参数解释 前置用例关联信息 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| tear_down_cases_info | 否 | Array of AssignCaseInfo objects | 参数解释 后置用例关联信息 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| case_uri | 否 | String | 参数解释 用例uri 约束限制 不涉及 取值范围 11-34位字母/数字 默认取值 不涉及 |
| is_available | 否 | Integer | 参数解释 是否可用 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| field_name | 否 | String | 参数解释 字段名称 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| old_value | 否 | String | 参数解释 旧的value 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| new_value | 否 | String | 参数解释 新的value 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| old_key | 否 | String | 参数解释 旧的key 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| new_key | 否 | String | 参数解释 新的key 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| value | String | 参数解释 请求返回的数据 取值范围 不涉及 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
请求示例
新增测试套任务
post https://{endpoint}/v4/300c6295a54c4c698608c878f47ddd59/tasks
{
"name" : "testsuite01",
"service_type" : 0,
"number" : "",
"description" : "",
"case_operation_info" : {
"set_up_cases_info" : [ ],
"tear_down_cases_info" : [ ],
"test_cases_info" : [ ]
},
"tags" : [ ],
"module_id" : "",
"module_name" : "",
"execute_way" : 1,
"ext_param" : "{}",
"release_dev" : "",
"version_uri" : "v91j0000vldleodb",
"plan_start_timestamp" : null,
"plan_end_timestamp" : null
} 响应示例
状态码：200
OK
{
"value" : "v91k0000vrpia8j3"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |
| 500 | Internal Server Error |
错误码
请参见错误码。
