更新时间:2026-10-22 GMT+08:00
分享

修改分支 - UpdateBranchGt

功能介绍

此接口用于对指定项目下的指定分支进行编辑操作,可修改分支名等属性

调用方法

请参见如何调用API。

URI

PUT /GT3KServer/v4/branches/{branch_id}

表1 路径参数

参数

是否必选

参数类型

描述

branch_id

是

String

分支URI

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

参数解释

名称

约束限制

取值范围

3-128位字符串

默认取值

不涉及

number

否

String

参数解释

编号(类似用例编号,版本唯一)

约束限制

不涉及

取值范围

长度小于768

默认取值

不涉及

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

约束限制

不涉及

取值范围

(传入微服务ID)

默认取值

不涉及

project_name

否

String

参数解释

项目名称

约束限制

不涉及

取值范围

(传入微服务名)

默认取值

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

value

TestVersionVo object

参数解释

版本资源信息

取值范围

不涉及

表4 TestVersionVo

参数

参数类型

描述

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:非Master分支

  • 1:Master分支

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

参数解释:

服务类型集合,数组内每个integer值代表的服务类型含义:-1表示全量用例,0表示手工测试,1表示接口自动化,7表示功能自动化,8表示WebUI自动化,100表示自定义自动化(工厂),11表示性能自动化

取值范围:

不涉及

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

表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

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/GT3KServer/v4/branches/1232sgs

{
  "project_uuid" : "f3087a82b44744c29a1bd69ab6ada154",
  "name" : "分支1",
  "is_master" : "false"
}

响应示例

状态码:200

{
  "status" : "string",
  "result" : {
    "total" : 1,
    "value" : {
      "uri" : "12334",
      "rank" : 1,
      "version_uri" : "123saas54gh"
    }
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档