# 新增迭代（2.0） - CreateIteratorV4 #### 功能介绍 此接口用于在项目下创建计划,同页面 测试 -\> 测试计划 -\> 点击新建计划按钮 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/iterators 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | branch_uri | 是 | String | **参数解释** 分支URI **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中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](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制** 不涉及 **取值范围** 项目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 -\> 迭代 -\> 需求 **取值范围** 不涉及 **默认取值** 不涉及 | 表4WorkItemInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | work_item_id | 是 | String | **参数解释** 工作项编号 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | has_child | 是 | Boolean | **参数解释** 是否有子需求 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** true:是 false:否 | | is_open | 是 | Boolean | **参数解释** 是否展开 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** true:是 false:否 | | child_list | 否 | Array of [WorkItemInfo] objects | **参数解释** 子需求 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | 表5TestCaseAttachmentInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | override | 否 | Boolean | **参数解释** 附件是否要被覆盖 **约束限制** 不涉及 **取值范围** true\|false **默认取值** 不涉及 | | doc_id | 否 | String | **参数解释** 文档id **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | file_name | 是 | String | **参数解释** 文件名 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | file_path | 否 | String | **参数解释** 文件路径 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | file_type | 否 | String | **参数解释**: 文件类型 **约束限制**: 根据文件后缀扩展名填入 **取值范围**: - txt，文本文件。 - img，图片文件。 等等 **默认取值**: 不涉及 | | file_size | 否 | String | **参数解释** 文件大小 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | override_id | 否 | String | **参数解释** 重复用例ID **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | related_type | 否 | String | **参数解释**: 相关类型 **约束限制**: 不涉及 **取值范围**: - 0，本地上传。 - 1，关联文档。 **默认取值**: 不涉及 | | store_file_name | 否 | String | **参数解释** 保存文件名 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | system_type | 否 | String | **参数解释**: 系统类型 **约束限制**: 根据系统类型传入对应的值 **取值范围**: - docman，docman系统。 - testman，testman系统。 **默认取值**: 不涉及 | | storage_system | 否 | String | **参数解释** 区分文件存储系统 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | #### 响应参数 **状态码：200** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | [TestVersionVo] object | **参数解释** 版本资源信息 **取值范围** 不涉及 | 表7TestVersionVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释**: 资源URI **取值范围**: 11-34位长度的字母、数字组成的字符串 | | type | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - Task，任务。 - TestVersion，分支。 - IteratorTestCase，迭代用例。 | | author | String | **参数解释**: 创建人 **取值范围**: 长度小于128个字符的字符串 | | name | String | **参数解释**: 名称 **取值范围**: 长度小于128个字符的字符串 | | rank | Integer | **参数解释**: 级别 **取值范围**: 1\|2\|3\|4 | | version | String | **参数解释**: 待测版本 **取值范围**: 不涉及 | | owner | String | **参数解释**: 处理者ID **取值范围**: 长度小于128个字符的字符串 | | creator | String | **参数解释**: 创建人ID **取值范围**: 长度小于128个字符的字符串 | | iterations | String | **参数解释**: 关联迭代 **取值范围**: 长度小于128个字符的字符串 | | description | String | **参数解释**: 描述 **取值范围**: 长度小于1024个字符的字符串 | | region | String | **参数解释**: 区域 **取值范围**: 不涉及 | | last_modifier | String | **参数解释**: 最后修改人 **取值范围**: 长度小于128个字符的字符串 | | last_modified | String | **参数解释**: 最后修改时间 **取值范围**: 不涉及，格式：yyyy-MM-dd HH:mm:ss | | last_modified_timestamp | Long | **参数解释**: 修改时间时间戳 **取值范围**: 不涉及，单位：毫秒级 | | last_change_time | String | **参数解释**: 最后变更时间 **取值范围**: 不涉及，格式：yyyy-MM-dd HH:mm:ss | | version_uri | String | **参数解释**: 版本URI **取值范围**: 11-34位字母、数字组成的字符串 | | origin_uri | String | **参数解释**: 源资源URI **取值范围**: 11-34位字母、数字组成的字符串 | | parent_uri | String | **参数解释**: 父资源URI **取值范围**: 11-34位字母、数字组成的字符串 | | parent_path | String | **参数解释**: 父资源路径 **取值范围**: 长度小于128个字符的字符串 | | creation_version_uri | String | **参数解释**: 创建版本URI **取值范围**: 11-34位字母、数字组成的字符串 | | creation_date | String | **参数解释**: 创建时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss" | | creation_date_timestamp | Long | **参数解释**: 创建时间时间戳 **取值范围**: 不涉及，单位：毫秒级 | | author_name | String | **参数解释**: 创建人名称 **取值范围**: 长度小于128个字符的字符串 | | comment | String | **参数解释**: 备注 **取值范围**: 长度小于1024个字符的字符串 | | number | String | **参数解释**: 编号 **取值范围**: 长度小于128个字符的字符串 | | is_master | Integer | **参数解释**: 是否为Master分支 **取值范围**: 0\|1 | | is_iterator | Integer | **参数解释**: 是否为迭代 **取值范围**: 0\|1 | | plan_start_date | String | **参数解释**: 开始时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss" | | plan_end_date | String | **参数解释**: 结束时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss" | | service_id | String | **参数解释**: 微服务ID **取值范围**: 长度小于128个字符的字符串 | | service_name | String | **参数解释**: 微服务名 **取值范围**: 长度小于128个字符的字符串 | | pbi_id | String | **参数解释**: PBI ID **取值范围**: 长度小于128个字符的字符串 | | pbi_name | String | **参数解释**: PBI信息 **取值范围**: 长度小于128个字符的字符串 | | plan_id | String | **参数解释**: 计划ID **取值范围**: 11-34位字母和数字组成的字符串 | | metric_pbi_ids | String | **参数解释**: 度量PBI ID **取值范围**: 长度小于128个字符的字符串 | | metric_pbi_id_names | String | **参数解释**: 度量PBI名称 **取值范围**: 长度小于128个字符的字符串 | | last_syn_date | String | **参数解释**: 最后同步时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss" | | is_closed | String | **参数解释**: 版本是否关闭 **取值范围**: 不涉及 | | asyn_git | String | **参数解释**: 是否同步git库 **取值范围**: 不涉及 | | schema_no | Integer | **参数解释**: schema编号 **取值范围**: 1-10 | | finish_date | String | **参数解释**: 迭代实际完成时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss" | | owner_name | String | **参数解释**: 处理者名称 **取值范围**: 长度小于128个字符的字符串 | | creator_name | String | **参数解释**: 创建人名称 **取值范围**: 长度小于128个字符的字符串 | | current_stage | String | **参数解释**: 当前所处阶段 **取值范围**: create\|strategy\|design\|execute\|report | | service_types | Array of integers | **参数解释**: 服务类型 **取值范围**: 不涉及 | | risk_rating | Integer | **参数解释**: 风险等级 **取值范围**: 0\|1\|2\|3\|4\|5 | | risk_des | String | **参数解释**: 风险描述 **取值范围**: 最大长度500位字符 | | project_uuid | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围**: 32位字母和数字组成的字符串 | | domain_id | String | **参数解释**: 租户ID **取值范围**: 11-34位字母和数字组成的字符串 | | pi_id | String | **参数解释**: pi的id **取值范围**: 不涉及 | **状态码：400** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表11响应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** OK ``` { "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" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。