新增迭代（2.0） - CreateIteratorV4

功能介绍

此接口用于在项目下创建计划,同页面测试 -> 测试计划 -> 单击新建计划按钮。

调用方法

URI

POST /v4/iterators

表1 Query参数
参数	是否必选	参数类型	描述
branch_uri	是	String	参数解释分支URI 约束限制不涉及取值范围不涉及默认取值不涉及

请求参数

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

表3 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	参数解释名称约束限制不涉及取值范围不涉及默认取值不涉及
number	否	String	参数解释开发分支名称约束限制不涉及取值范围不涉及默认取值不涉及
owner	是	String	参数解释处理者ID 约束限制不涉及取值范围不涉及默认取值不涉及
version	否	String	参数解释待测版本约束限制不涉及取值范围不涉及默认取值不涉及
description	否	String	参数解释描述约束限制不涉及取值范围不涉及默认取值不涉及
iterations	否	Array of strings	参数解释关联迭代约束限制不涉及取值范围不涉及默认取值不涉及
is_master	否	String	参数解释是否为Master分支约束限制不涉及取值范围不涉及默认取值不涉及
pbi_id	否	String	参数解释 PBI ID 约束限制不涉及取值范围不涉及默认取值不涉及
pbi_name	否	String	参数解释 PBI信息约束限制不涉及取值范围不涉及默认取值不涉及
plan_start_date	是	String	参数解释开始时间约束限制不涉及取值范围不涉及默认取值不涉及
plan_start_timestamp	否	Long	参数解释开始时间戳约束限制不涉及取值范围不涉及默认取值不涉及
plan_end_date	是	String	参数解释结束时间约束限制不涉及取值范围不涉及默认取值不涉及
plan_end_timestamp	否	Long	参数解释结束时间戳约束限制不涉及取值范围不涉及默认取值不涉及
asyn_git	否	String	参数解释是否同步git库约束限制不涉及取值范围不涉及默认取值不涉及
project_uuid	是	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制不涉及取值范围项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值不涉及
project_name	否	String	参数解释项目名称约束限制不涉及取值范围（传入微服务名）默认取值不涉及
current_stage	否	String	参数解释当前所处阶段约束限制不涉及取值范围不涉及默认取值不涉及
service_types	是	Array of strings	参数解释测试类型约束限制不涉及取值范围不涉及默认取值不涉及
issue_list	否	Array of WorkItemInfo objects	参数解释关联需求约束限制不涉及取值范围不涉及默认取值不涉及
risk_rating	否	Integer	参数解释风险等级约束限制不涉及取值范围不涉及默认取值不涉及
risk_des	否	String	参数解释风险描述约束限制不涉及取值范围不涉及默认取值不涉及
is_update_risk	否	String	参数解释编辑风险信息标记约束限制不涉及取值范围不涉及默认取值不涉及
pi_id	否	String	参数解释 pi的id 约束限制层级关系：pi -> 迭代 -> 需求取值范围不涉及默认取值不涉及

表4 WorkItemInfo
参数	是否必选	参数类型	描述
work_item_id	是	String	参数解释工作项编号约束限制不涉及取值范围不涉及默认取值不涉及
has_child	是	Boolean	参数解释是否有子需求约束限制不涉及取值范围不涉及默认取值 true:是 false:否
is_open	是	Boolean	参数解释是否展开约束限制不涉及取值范围不涉及默认取值 true:是 false:否
child_list	否	Array of WorkItemInfo objects	参数解释子需求约束限制不涉及取值范围不涉及默认取值不涉及

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
value	TestVersionVo object	参数解释版本资源信息取值范围不涉及

表6 TestVersionVo
参数	参数类型	描述
uri	String	参数解释: 资源URI 取值范围: 11-34位长度的字母、数字组成的字符串
type	String	参数解释: 资源类型取值范围: TestCase，用例。 Task，任务。 TestVersion，分支。 IteratorTestCase，迭代用例。
author	String	参数解释: 创建人取值范围: 不涉及
name	String	参数解释: 名称取值范围: 不涉及
rank	Integer	参数解释: 级别取值范围: 1\|2\|3\|4
version	String	参数解释: 待测版本取值范围: 不涉及
owner	String	参数解释: 处理者ID 取值范围: 不涉及
creator	String	参数解释: 创建人ID 取值范围: 不涉及
iterations	String	参数解释: 关联迭代取值范围: 不涉及
description	String	参数解释: 描述取值范围: 不涉及
region	String	参数解释: 区域取值范围: 不涉及
last_modifier	String	参数解释: 最后修改人取值范围: 不涉及
last_modified	String	参数解释: 最后修改时间取值范围: 不涉及
last_modified_timestamp	Long	参数解释: 修改时间时间戳取值范围: 不涉及
last_change_time	String	参数解释: 最后变更时间取值范围: 不涉及
version_uri	String	参数解释: 版本URI 取值范围: 11-34位字母、数字组成的字符串
origin_uri	String	参数解释: 源资源URI 取值范围: 11-34位字母、数字组成的字符串
parent_uri	String	参数解释: 父资源URI 取值范围: 不涉及
parent_path	String	参数解释: 父资源路径取值范围: 不涉及
creation_version_uri	String	参数解释: 创建版本URI 取值范围: 11-34位字母、数字组成的字符串
creation_date	String	参数解释: 创建时间取值范围: 不涉及
creation_date_timestamp	Long	参数解释: 创建时间时间戳取值范围: 不涉及
author_name	String	参数解释: 创建人名称取值范围: 不涉及
comment	String	参数解释: 备注取值范围: 不涉及
number	String	参数解释: 编号取值范围: 不涉及
is_master	Integer	参数解释: 是否为Master分支取值范围: 0\|1
is_iterator	Integer	参数解释: 是否为迭代取值范围: 0\|1
plan_start_date	String	参数解释: 开始时间取值范围: 不涉及
plan_end_date	String	参数解释: 结束时间取值范围: 不涉及
service_id	String	参数解释: 微服务ID 取值范围: 不涉及
service_name	String	参数解释: 微服务名取值范围: 不涉及
pbi_id	String	参数解释: PBI ID 取值范围: 不涉及
pbi_name	String	参数解释: PBI信息取值范围: 不涉及
plan_id	String	参数解释: 计划ID 取值范围: 11-34位字母和数字组成的字符串
metric_pbi_ids	String	参数解释: 度量PBI ID 取值范围: 不涉及
metric_pbi_id_names	String	参数解释: 度量PBI名称取值范围: 不涉及
last_syn_date	String	参数解释: 最后同步时间取值范围: 不涉及
is_closed	String	参数解释: 版本是否关闭取值范围: 不涉及
asyn_git	String	参数解释: 是否同步git库取值范围: 不涉及
schema_no	Integer	参数解释: schema编号取值范围: 1-10
finish_date	String	参数解释: 迭代实际完成时间取值范围: 不涉及
owner_name	String	参数解释: 处理者名称取值范围: 不涉及
creator_name	String	参数解释: 创建人名称取值范围: 不涉及
current_stage	String	参数解释: 当前所处阶段取值范围: create\|strategy\|design\|execute\|report
service_types	String	参数解释: 服务类型取值范围: 不涉及
risk_rating	Integer	参数解释: 风险等级取值范围: 0\|1\|2\|3\|4\|5
risk_des	String	参数解释: 风险描述取值范围: 最大长度500位字符
project_uuid	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围: 32位字母和数字组成的字符串
domain_id	String	参数解释: 租户ID 取值范围: 11-34位字母和数字组成的字符串
pi_id	String	参数解释: pi的id 取值范围: 不涉及

状态码：400

表7 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：401

表8 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：404

表9 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：500

**表10** 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

请求示例

post https://{endpoint}/GT3KServer/v4/iterators?branch_uri=v92s00010db208e5

{
  "name" : "branches",
  "project_uuid" : "3c913532482340e69b9b724f6732c67c",
  "owner" : "user1",
  "service_types" : [ "0", "1" ],
  "plan_start_date" : "2025-10-20 15:05:03",
  "plan_end_date" : "2025-10-22 15:05:00"
}

响应示例

状态码：200

{
  "value" : {
    "uri" : "v92u00010e7dkink",
    "type" : "TestVersion",
    "author" : "f3b807a0d249424fa36a0d804110c4ed",
    "name" : "这是一个测试计划",
    "version" : "基线_版本",
    "owner" : "f3b807a0d249424fa36a0d804110c4ed",
    "iterations" : "[]",
    "region" : "cn-north-7",
    "last_modifier" : "f3b807a0d249424fa36a0d804110c4ed",
    "last_modified" : "2025-04-28 16:46:40",
    "last_change_time" : "2025-04-28 16:46:40",
    "version_uri" : "v92s00010db208e5",
    "parent_uri" : "v92s00010db208e5",
    "parent_path" : "/dc3f9aa646ad4707831080d3fcce474d/v92s00010db208e5/",
    "creation_version_uri" : "v92s00010db208e5",
    "creation_date" : "2025-04-28 16:46:40",
    "is_master" : 0,
    "is_iterator" : 1,
    "plan_start_date" : "2025-04-28 00:00:00",
    "plan_end_date" : "2025-04-28 23:59:59",
    "service_id" : "dc3f9aa646ad4707831080d3fcce474d",
    "service_name" : "【车联网示例项目】车联网云服务-GJX",
    "schema_no" : 1,
    "current_stage" : "create",
    "service_types" : "[\"0\",\"11\",\"1\",\"100\",\"6\",\"8\",\"32\"]",
    "risk_rating" : 0,
    "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d"
  }
}