创建分支
URI
POST /v2/repositories/{repository_id}/branches
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
repository_id | 是 | String | 参数解释: 仓库短ID,进入仓库的“代码”页面,仓库名称下的“Repository ID”即为仓库ID。 约束限制: 不涉及。 取值范围: 只能由数字组成,数字可取范围为1~2147483647。 默认取值: 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度为1~100000。 默认取值: 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
branch_name | 是 | String | 参数解释: 分支名称。 约束限制: 不涉及。 取值范围: 长度为1~200。 默认取值: 不涉及。 |
ref | 是 | String | 参数解释: 源分支名称。 约束限制: 不涉及。 取值范围: 长度为1~200。 默认取值: 不涉及。 |
响应参数
状态码: 200
参数 | 参数类型 | 描述 |
|---|---|---|
error | Error object | 参数解释: 响应错误码。 取值范围: 不涉及。 |
result | AddProtectResponse object | 参数解释: 响应结果。 取值范围: 不涉及。 |
status | String | 参数解释: 调用此接口的响应状态。 取值范围:
|
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 参数解释: 分支名称。 取值范围: 不涉及。 |
commit | CommitRepoV2 object | 参数解释: 提交信息。 取值范围: 不涉及。 |
protected | Boolean | 参数解释: 是否为保护分支。 取值范围:
|
developers_can_push | Boolean | 参数解释: 是否允许开发者提交。 取值范围:
|
developers_can_merge | Boolean | 参数解释: 是否允许开发者合并。 取值范围:
|
master_can_push | Boolean | 参数解释: 是否允许管理员提交。 取值范围:
|
master_can_merge | Boolean | 参数解释: 是否允许管理员合并。 取值范围:
|
no_one_can_push | Boolean | 参数解释: 是否允许提交。 取值范围:
|
no_one_can_merge | Boolean | 参数解释: 是否允许合并。 取值范围:
|
in_an_opened_merge_request | Boolean | 参数解释: 是否存在开启的该分支相关的合并请求。 取值范围:
|
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 提交对应的SHA id,即Git版本控制系统中用于唯一标识每个提交(commit)的40位十六进制字符串。 取值范围: 不涉及。 |
short_id | String | 参数解释: 提交对应的短SHA id。 取值范围: 不涉及。 |
created_at | String | 参数解释: 创建时间。 取值范围: 不涉及。 |
title | String | 参数解释: 提交标题。 取值范围: 不涉及。 |
parent_ids | Array of strings | 参数解释: 父提交id。 取值范围: 不涉及。 |
message | String | 参数解释: 提交信息。 取值范围: 不涉及。 |
author_name | String | 参数解释: 作者。 取值范围: 不涉及。 |
committer_name | String | 参数解释: 提交者。 取值范围: 不涉及。 |
committed_date | String | 参数解释: 提交时间。 取值范围: 不涉及。 |
请求示例
{
"ref" : "master",
"branch_name" : "test"
} 响应示例
状态码: 200
OK
{
"result" : {
"name" : "master",
"commit" : {
"id" : "3b68902cf0eb7de3d5c8757e4a990bc3fe0af349",
"short_id" : "3b68902c",
"title" : "新建文件",
"created_at" : "2022-03-08T03:14:39.000Z",
"parent_ids" : [ "08618c900a4048aae7e4cd88913d3d521eae02eb" ],
"message" : "新建文件",
"author_name" : "repo",
"committer_name" : "repo",
"committed_date" : "2022-03-08T03:14:39.000Z"
},
"protected" : true,
"developers_can_push" : false,
"developers_can_merge" : false,
"master_can_push" : false,
"master_can_merge" : false,
"no_one_can_push" : true,
"no_one_can_merge" : true,
"in_an_opened_merge_request" : false
},
"status" : "success"
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
错误码
请参见错误码。


