本文导读

展开导读

文档首页/ 测试计划 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

错误码

请参见错误码。

父主题： 测试计划管理

上一篇：查询某个测试计划下的需求树

下一篇：查询某测试计划下的操作历史

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

项目下创建计划

功能介绍

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

意见反馈

文档内容是否对您有帮助？

文档反馈