# 修改分支 - UpdateBranch #### 功能介绍 此接口用于在版本管理中修改分支,对应页面 测试 -\> 测试用例 -\> 上方版本右侧小齿轮 -\> 列表中修改分支 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI PUT /v4/branches/{branch_uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | branch_uri | 是 | String | 分支URI | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | 名称 | | number | 否 | String | 开发分支名称 | | 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)。 | | project_name | 否 | String | 项目名称（传入微服务名） | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | [TestVersionVo] object | 实际的数据类型：单个对象，集合 或 NULL | | reason | String | 业务失败的提示内容 | | page_size | Integer | 分页大小 | | page_no | Integer | 分页编码 | | has_more | Boolean | 是否有更多 | 表4TestVersionVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 资源URI | | type | String | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。 - Task，任务。 - TestVersion，分支。 - IteratorTestCase，迭代用例。 | | author | String | 创建人 | | name | String | 名称 | | rank | Integer | 级别 | | 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 | | origin_uri | String | 源资源URI | | parent_uri | String | 父资源URI | | parent_path | String | 父资源路径 | | creation_version_uri | String | 创建版本URI | | creation_date | String | 创建时间 | | creation_date_timestamp | Long | 创建时间时间戳 | | author_name | String | 创建人名称 | | comment | String | 备注 | | number | String | 编号 | | is_master | Integer | 是否为Master分支 | | is_iterator | Integer | 是否为迭代 | | 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 | | 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编号 | | finish_date | String | 迭代实际完成时间 | | owner_name | String | 处理者名称 | | creator_name | String | 创建人名称 | | current_stage | String | 当前所处阶段 | | service_types | String | 服务类型 | | risk_rating | Integer | 风险等级 | | risk_des | String | 风险描述 | | project_uuid | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | | domain_id | String | 租户ID | | pi_id | String | pi的id | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 | #### 请求示例 ``` put https://{endpoint}/v4/branches/45248sf32ee { "project_uuid" : "f3087a82b44744c29a1bd69ab6ada154", "name" : "新分支", "number" : "12222" } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "uri" : "3", "type" : 0, "name" : "新分支" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。