新增分支 - CreateProjectBranchv4
功能介绍
新增分支
调用方法
请参见如何调用API。
URI
POST /v4/branches
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| value | TestVersionVo object | 参数解释 版本资源信息 取值范围 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| uri | String | 参数解释: 资源URI 取值范围: 11-34位长度的字母、数字组成的字符串 |
| type | String | 参数解释: 资源类型 取值范围:
|
| 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
{
"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 |
错误码
请参见错误码。