文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试计划管理/ 项目下创建计划
更新时间：2025-04-30 GMT+08:00
查看PDF
分享

项目下创建计划

功能介绍

项目下创建计划

URI

POST /v1/projects/{project_id}/plans

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目唯一标识，固定长度32位字符，获取方式请参见获取项目ID。

约束限制：

固定长度32位字符

取值范围:

字母、数字

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

参数

是否必选

参数类型

描述

assigned_id

否

String

参数解释:

处理者id，不填时默认使用当前用户

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

name

是

String

参数解释:

计划名称

约束限制:

长度128位字符

取值范围:

不涉及

默认取值:

不涉及

plan_cycle

是

PlanCycle object

计划周期

service_id_list

是

Array of integers

参数解释:

计划下包含的用例类型，数组长度小于10个

约束限制:

最大长度10

取值范围:

不涉及

默认取值:

不涉及
表4 PlanCycle

参数

是否必选

参数类型

描述

end_date

是

String

参数解释:

计划结束时间，要求用UTC时间表示。如2020-03-31

约束限制:

UTC时间表示

取值范围:

不涉及

默认取值:

不涉及

start_date

是

String

参数解释:

计划开始时间，要求用UTC时间表示。如2020-03-04

约束限制:

UTC时间表示

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码：201

表5 响应Body参数

参数

参数类型

描述

plan_id

String

参数解释:

接口调用成功返回的计划id

取值范围:

不涉及

error_code

String

参数解释:

接口调用成功不返回，调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用成功不返回，调用失败错误信息

取值范围:

不涉及

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

项目下创建计划

post https://{endpoint}/v1/projects/efdb403066474ab08836b9eeaaa23bca/plans

{
  "assigned_id" : "efdb403066474ab08836b9eeaaa23bca",
  "name" : "这是一个测试计划名称",
  "plan_cycle" : {
    "end_date" : "2020-03-31",
    "start_date" : "2020-03-04"
  },
  "service_id_list" : [ 13, 24 ]
}

响应示例

状态码：201

Created

{
  "plan_id" : "b66aab5469cc4ab39b0dda8e644a42a4",
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "接口调用失败错误信息"
}

状态码

状态码

描述

201

Created

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试计划管理