新增分支
功能介绍
新增分支
调用方法
请参见如何调用API。
URI
POST /v4/branches
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 约束限制 不涉及 取值范围 （云龙场景，传入微服务ID） 默认取值 不涉及 |
|
project_name |
否 |
String |
参数解释 项目名称 约束限制 不涉及 取值范围 （云龙场景，传入微服务名） 默认取值 不涉及 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
参数解释 本次请求的处理状态 取值范围 success|error |
|
result |
ResultValueTestVersionVo object |
参数解释 版本资源信息 取值范围 不涉及 |
|
error |
ApiError object |
参数解释 错误信息 取值范围 不涉及 |
|
request_id |
String |
参数解释 请求的唯一id 取值范围 由接口调用方传入，建议使用UUID保证请求的唯一性 |
|
server_address |
String |
参数解释 本次请求的受理的服务地址 取值范围 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
参数解释 符合条件的所有记录数 取值范围 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 |
|
value |
TestVersionVo object |
参数解释 版本资源信息 取值范围 不涉及 |
|
reason |
String |
参数解释 业务失败的提示内容 取值范围 不涉及 |
|
page_size |
Integer |
参数解释 分页大小 取值范围 不涉及 |
|
page_no |
Integer |
参数解释 分页编号 取值范围 不涉及 |
|
has_more |
Boolean |
参数解释 是否有更多 取值范围 true:是 false:否 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
uri |
String |
参数解释: 资源URI 取值范围: 11-34位长度的字母、数字组成的字符串 |
|
type |
String |
参数解释: 资源类型 取值返回: TestVersion |
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 业务失败的错误码 取值范围: 不涉及 |
|
reason |
String |
参数解释: 业务失败的提示内容 取值范围: 不涉及 |
请求示例
put https://{endpoint}/GT3KServer/v4/branches
{
"project_uuid" : "dc3f9aa646ad4707831080d3fcce474d",
"name" : "cxc",
"project_name" : "【车联网示例项目】车联网云服务-GJX"
}响应示例
状态码：200
OK
{
"status" : "success",
"result" : {
"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 |
错误码
请参见错误码。
