本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 更新测试套任务

更新测试套任务

更新时间：2025-06-26 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

更新测试套任务

调用方法

请参见如何调用API。

URI

PUT /v4/{project_id}/tasks/{task_uri}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 不涉及取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值: 不涉及
task_uri	是	String	任务uri

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：字符串长度不少于1，不超过10万。默认取值：不涉及。

表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	参数解释: 错误信息取值范围: 非必返
request_id	String	参数解释: 请求的唯一id 取值范围: 非必返
address	String	参数解释: 本次请求的受理的服务地址。取值范围: 非必返

表8 ResultValueString
参数	参数类型	描述
value	String	参数解释 resultObject 取值范围不涉及

表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	参数解释: 接口调用失败错误信息取值范围: 不涉及

请求示例

更新测试套任务

put https://{endpoint}/v4/300c6295a54c4c698608c878f47ddd59/tasks/v91j0000vldlep5u

{
  "description" : "",
  "name" : "样例功能套件",
  "owner_id" : "e8d27b5521a64fb28a8fd9c99cd66eb3",
  "tags" : [ "tag1" ],
  "number" : "002",
  "service_type" : 0,
  "status_code" : "0",
  "module_name" : "",
  "release_dev" : "",
  "execute_way" : 1,
  "version_uri" : "v91j0000vldleodb",
  "plan_start_timestamp" : -1,
  "plan_end_timestamp" : -1
}

响应示例

状态码：200

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

状态码


状态码	描述
200	OK
400	Bad Request
401	Unauthorized
404	Not Found
500	Internal Server Error

错误码

请参见错误码。

父主题： 测试套管理

上一篇：获取测试套任务详情

下一篇：初始化用例执行记录

意见反馈

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

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

更新测试套任务

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

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

文档反馈