更新测试套任务 - UpdateTask

功能介绍

更新测试套任务

调用方法

请参见如何调用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 约束限制不涉及取值范围 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	参数解释自定义字段的更新记录约束限制不涉及取值范围不涉及默认取值不涉及

表4 CaseOperationInfo
参数	是否必选	参数类型	描述
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	参数解释后置用例关联信息约束限制不涉及取值范围不涉及默认取值不涉及

表5 AssignCaseInfo
参数	是否必选	参数类型	描述
case_uri	否	String	参数解释用例uri 约束限制不涉及取值范围 11-34位字母/数字默认取值不涉及
is_available	否	Integer	参数解释是否可用约束限制不涉及取值范围 true:是 false:否默认取值不涉及

表6 ResourceChangeInfo
参数	是否必选	参数类型	描述
field_name	否	String	参数解释字段名称约束限制不涉及取值范围不涉及默认取值不涉及
old_value	否	String	参数解释旧的value 约束限制不涉及取值范围不涉及默认取值不涉及
new_value	否	String	参数解释新的value 约束限制不涉及取值范围不涉及默认取值不涉及
old_key	否	String	参数解释旧的key 约束限制不涉及取值范围不涉及默认取值不涉及
new_key	否	String	参数解释新的key 约束限制不涉及取值范围不涉及默认取值不涉及

响应参数

状态码：200

表7 响应Body参数
参数	参数类型	描述
value	String	参数解释请求返回的数据取值范围不涉及

状态码：400

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：401

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：404

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：500

**表11** 响应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
}