# 获取分支列表 - ListAllBranchesv4 #### 功能介绍 此接口用于获取分支列表，同页面 测试 -\> 测试计划 -\> 右侧展示页面，点击左上角分支筛选栏右侧设置键 -\> 进入版本管理页面，下方展示分支列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v4/branches 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_uuid | 是 | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制** 不涉及 **取值范围** 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字的字符串 **默认取值** 不涉及 | | sort_field | 否 | String | **参数解释** 排序字段 **约束限制** 不涉及 **取值范围** 长度小于128个字符的字符串 **默认取值** 无 | | sort_type | 否 | String | **参数解释**: 排序方式 **约束限制**: 不涉及 **取值范围**: - ASC，升序。 - DESC，降序。 **默认取值**: 无 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | Array of [TestVersionVo] objects | **参数解释** 请求返回的数据 **取值范围** 不涉及 | 表4TestVersionVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及 | | reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 | #### 请求示例 ``` GET https://{endpoint}/GT3KServer/v4/branches?project_uuid=b318f1f3fcef44dd8d549c3624ea8955 ``` #### 响应示例 **状态码：200** OK ``` { "value" : [ { "uri" : "v90j0001004q3pfj", "type" : "TestVersion", "author" : "83e08a7416094ceca63f79cb7f8ef4ad", "name" : "基线", "region" : "suzhou-roma-1", "last_modifier" : "83e08a7416094ceca63f79cb7f8ef4ad", "last_modified" : "2024-11-04 16:47:12", "last_modified_timestamp" : 1730710032000, "last_change_time" : "2024-11-04 16:47:12", "version_uri" : "b318f1f3fcef44dd8d549c3624ea8955", "parent_uri" : "b318f1f3fcef44dd8d549c3624ea8955", "parent_path" : "/b318f1f3fcef44dd8d549c3624ea8955/", "creation_version_uri" : "b318f1f3fcef44dd8d549c3624ea8955", "creation_date" : "2024-11-04 16:47:12", "creation_date_timestamp" : 1730710032000, "author_name" : "manage_admin", "is_master" : 1, "is_iterator" : 0, "service_id" : "b318f1f3fcef44dd8d549c3624ea8955", "service_name" : "项目11", "schema_no" : 8, "risk_rating" : 0, "project_uuid" : "b318f1f3fcef44dd8d549c3624ea8955" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。