# 修改迭代 - UpdateIteratorFour #### 功能介绍 此接口用于修改迭代,同页面 测试 -\> 测试计划 -\> 右侧上方点击筛选分支 -\> 进入版本管理进行修改 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI PUT /v4/iterators/{iterator_uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | iterator_uri | 是 | String | 迭代URI | #### 请求参数 表2请求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 -\> 迭代 -\> 需求 **取值范围** 不涉及 **默认取值** 不涉及 | 表3WorkItemInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | work_item_id | 是 | String | **参数解释** 工作项编号 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | has_child | 是 | Boolean | **参数解释** 是否有子需求 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** true:是 false:否 | | is_open | 是 | Boolean | **参数解释** 是否展开 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** true:是 false:否 | | child_list | 否 | Array of [WorkItemInfo] objects | **参数解释** 子需求 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | 表4TestCaseAttachmentInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | [TestVersionVo] object | **参数解释** 版本资源信息 **取值范围** 不涉及 | 表6TestVersionVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` put https://{endpoint}/v4/iterators/2dopbu6aaf { "name" : "迭代1", "owner" : "c30045613", "service_types" : [ "0", "1", "6" ], "project_uuid" : "f3087a82b44744c29a1bd69ab6ada154", "project_name" : "新建项目1", "plan_start_date" : "2021-01-01 00:00:00", "plan_end_date" : "2021-01-01 00:00:00" } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "uri" : "v92s10cmov8ek1jd", "creator" : "st112323", "is_master" : "false" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。