更新时间:2025-12-27 GMT+08:00
分享

新增分支 - CreateProjectBranchv4

功能介绍

新增分支

调用方法

请参见如何调用API

URI

POST /v4/branches

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

表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

参数解释:

创建人

取值范围:

不涉及

name

String

参数解释:

名称

取值范围:

不涉及

rank

Integer

参数解释:

级别

取值范围:

1|2|3|4

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

取值范围:

11-34位字母、数字组成的字符串

origin_uri

String

参数解释:

源资源URI

取值范围:

11-34位字母、数字组成的字符串

parent_uri

String

参数解释:

父资源URI

取值范围:

不涉及

parent_path

String

参数解释:

父资源路径

取值范围:

不涉及

creation_version_uri

String

参数解释:

创建版本URI

取值范围:

11-34位字母、数字组成的字符串

creation_date

String

参数解释:

创建时间

取值范围:

不涉及

creation_date_timestamp

Long

参数解释:

创建时间时间戳

取值范围:

不涉及

author_name

String

参数解释:

创建人名称

取值范围:

不涉及

comment

String

参数解释:

备注

取值范围:

不涉及

number

String

参数解释:

编号

取值范围:

不涉及

is_master

Integer

参数解释:

是否为Master分支

取值范围:

0|1

is_iterator

Integer

参数解释:

是否为迭代

取值范围:

0|1

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

取值范围:

11-34位字母和数字组成的字符串

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编号

取值范围:

1-10

finish_date

String

参数解释:

迭代实际完成时间

取值范围:

不涉及

owner_name

String

参数解释:

处理者名称

取值范围:

不涉及

creator_name

String

参数解释:

创建人名称

取值范围:

不涉及

current_stage

String

参数解释:

当前所处阶段

取值范围:

create|strategy|design|execute|report

service_types

String

参数解释:

服务类型

取值范围:

不涉及

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参数

参数

参数类型

描述

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

参数解释:

业务失败的提示内容

取值范围:

不涉及

请求示例

put https://{endpoint}/GT3KServer/v4/branches

{
  "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d",
  "name" : "cxc",
  "project_name" : "【车联网示例项目】车联网云服务-GJX"
}

响应示例

状态码:200

OK

{
  "value" : {
    "uri" : "v92s00010e7ddfsn",
    "type" : "TestVersion",
    "author" : "f3b807a0d249424fa36a0d804110c4ed",
    "name" : "cxc",
    "region" : "cn-north-7",
    "last_modifier" : "f3b807a0d249424fa36a0d804110c4ed",
    "last_modified" : "2025-04-28 16:42:48",
    "last_change_time" : "2025-04-28 16:42:48",
    "version_uri" : "dc3f9aa646ad4707831080d3fcce474d",
    "parent_uri" : "dc3f9aa646ad4707831080d3fcce474d",
    "parent_path" : "/dc3f9aa646ad4707831080d3fcce474d/",
    "creation_version_uri" : "dc3f9aa646ad4707831080d3fcce474d",
    "creation_date" : "2025-04-28 16:42:48",
    "is_master" : 0,
    "is_iterator" : 0,
    "service_id" : "dc3f9aa646ad4707831080d3fcce474d",
    "service_name" : "【车联网示例项目】车联网云服务-GJX",
    "schema_no" : 1,
    "risk_rating" : 0,
    "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档