文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务测试套件管理/ 新增测试套任务
更新时间：2024-11-19 GMT+08:00
查看PDF
分享

新增测试套任务

功能介绍

新增测试套任务

URI

POST /v4/{project_id}/tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目id，对应"需求管理 CodeArts Req"项目唯一标识，测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值

约束限制:

不涉及

取值范围:

项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

uri

否

String

指定创建任务的uri

name

否

String

名称

stage

否

String

测试阶段

number

否

String

编号

tags

否

String

标记id

description

否

String

描述

region

否

String

区域

version_uri

否

String

分支/迭代uri

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

是否只需要修改测试套状态

is_async

否

Boolean

是否异步

changes

否

Array of ResourceChangeInfo objects

自定义字段的更新记录
表4 CaseOperationInfo

参数

是否必选

参数类型

描述

empty

否

Boolean

是否为空

test_cases_info

否

Array of AssignCaseInfo objects

用例关联信息

set_up_cases_info

否

Array of AssignCaseInfo objects

前置用例关联信息

tear_down_cases_info

否

Array of AssignCaseInfo objects

后置用例关联信息
表5 AssignCaseInfo

参数

是否必选

参数类型

描述

case_uri

否

String

用例uri

is_available

否

Integer

是否可用
表6 ResourceChangeInfo

参数

是否必选

参数类型

描述

field_name

否

String

字段名称

old_value

否

String

旧的value

new_value

否

String

新的value

old_key

否

String

旧的key

new_key

否

String

新的key

响应参数

状态码： 200

表7 响应Body参数

参数

参数类型

描述

status

String

success|error

result

ResultValueString object

请求的返回的数据对象

error

ApiError object

失败时的error信息

request_id

String

由接口调用方传入，建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址。
表8 ResultValueString

参数

参数类型

描述

value

String

testbird key
表9 ApiError

参数

参数类型

描述

code

String

业务失败的错误码

reason

String

业务失败的提示内容

状态码： 400

表10 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 401

表11 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 404

表12 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码： 500

表13 响应Body参数

参数

参数类型

描述

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

{
  "status" : "success",
  "result" : {
    "value" : "v91k0000vrpia8j3"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档