CreateProtectedBranch - 创建保护分支_云效(Apsara Devops)-阿里云帮助中心

通过OpenAPI创建保护分支。

适用版本

企业标准版

服务接入点与授权信息

获取服务接入点，替换 API 请求语法中的 <domain> ：服务接入点（domain）。
获取个人访问令牌，具体操作，请参见获取个人访问令牌。

产品	资源	所需权限
代码管理	保护分支	读写

请求语法

POST https://{domain}/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/protectedBranches

请求头

参数	类型	是否必填	描述	示例值
x-yunxiao-token	string	是	个人访问令牌。	pt-0fh3**0fbG_35af**0484

请求参数

参数	类型	位置	是否必填	描述	示例值
organizationId	string	path	是	组织 ID。	60de7a6852743a5162b5f957
repositoryId	string	path	是	代码库 ID 或者 URL-Encoder 编码的全路径。	2813891
-	object	body	否
allowMergeRoles	array[integer]	body	否	允许合并的角色列表：40-管理员，30-开发者。	40
allowMergeUserIds	array[string]	body	否	允许合并的用户 ID 列表。	62c795c*****468af8
allowPushRoles	array[integer]	body	否	允许推送的角色列表：40-管理员，30-开发者。	40
allowPushUserIds	array[string]	body	否	允许推送用户 ID 列表。	62c795c*****468af8
branch	string	body	否	被保护分支名称。	protectBranch
mergeRequestSetting	object	body	否	要求合并前通过代码评审。
allowMergeRequestRoles	array[integer]	body	否	允许合并请求的角色列表。	40, 30
defaultAssignees	array[string]	body	否	默认评审人 ID 列表。	1234567891234567
isAllowSelfApproval	boolean	body	否	是否允许创建者通过代码评审。	true
isAllowSourceBranchPushUserApproval	boolean	body	否	是否允许源分支的提交者通过合并请求。	true
isRequireDiscussionProcessed	boolean	body	否	是否要求评审全部已解决。	true
isRequired	boolean	body	否	是否开启【要求合并前通过代码评审】。	true
isResetApprovalWhenNewPush	boolean	body	否	是否在有推送时重置评审状态。	true
minimumApproval	integer	body	否	评审通过的最少人数，仅普通模式生效。	1
mrMode	string	body	否	评审模式：general - 普通模式, codeowner - CodeOwner 模式。	general
whiteList	string	body	否	评审文件白名单；输入文件路径，多行以换行符隔开，通配符请使用英文格式。	**.java
testSetting	object	body	否	要求合并前通过自动化状态检查。
checkCheckRunConfig	object	body	否	运行检查。
checkRunCheckItems	array	body	否	配置项列表。
-	object	body	否
id	string	body	否	写入人的 ID。	62c795c*****468af8
name	string	body	否	check run 的名称。	测试流水线
required	boolean	body	否	是否作为卡点。	false
type	string	body	否	写入人类型：User。	User
checkCommitStatusConfig	object	body	否	提交状态。
commitStatusCheckItems	array	body	否	配置项列表。
-	object	body	否
context	string	body	否	三方提交状态的名称（以名称作为卡点的匹配项）。	""
required	boolean	body	否	是否作为卡点。	false
checkConfig	object	body	否	流水线检查。
checkItems	array	body	否	配置项列表。
-	object	body	否
isRequired	boolean	body	否	是否是卡点项。	false
pipelineId	integer	body	否	流水线 ID。	0
pipelineName	string	body	否	流水线名称。	""
checkTaskQualityConfig	object	body	否	代码检测任务。
bizNo	string	body	否	检测任务流水线号。	123456
enabled	boolean	body	否	是否开启代码检测。	false
message	string	body	否	描述信息。	test_task_quality
taskName	string	body	否	检测任务名称。	biz_task_quality
isRequired	boolean	body	否	是否开启【要求合并前通过自动化状态检查】。	false

请求示例

curl -X 'POST' \
  'https://test.rdc.aliyuncs.com/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/protectedBranches' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "allowMergeRoles": [
            40
        ],
        "allowMergeUserIds": [
            "62c795c*****468af8"
        ],
        "allowPushRoles": [
            40
        ],
        "allowPushUserIds": [
            "62c795c*****468af8"
        ],
        "branch": "protectBranch",
        "mergeRequestSetting": {
            "allowMergeRequestRoles": [
                40,
                30
            ],
            "defaultAssignees": [
                "1234567891234567"
            ],
            "isAllowSelfApproval": false,
            "isAllowSourceBranchPushUserApproval": false,
            "isRequireDiscussionProcessed": false,
            "isRequired": false,
            "isResetApprovalWhenNewPush": false,
            "minimumApproval": 0,
            "mrMode": "general",
            "whiteList": "**.java"
        },
        "testSetting": {
            "checkCheckRunConfig": {
                "checkRunCheckItems": [
                    {
                        "id": "62c795c*****468af8",
                        "name": "测试流水线",
                        "required": false,
                        "type": "User"
                    }
                ]
            },
            "checkCommitStatusConfig": {
                "commitStatusCheckItems": [
                    {
                        "context": "",
                        "required": false
                    }
                ]
            },
            "checkConfig": {
                "checkItems": [
                    {
                        "isRequired": false,
                        "pipelineId": 0,
                        "pipelineName": ""
                    }
                ]
            },
            "checkTaskQualityConfig": {
                "bizNo": "",
                "enabled": false,
                "message": "",
                "taskName": ""
            },
            "isRequired": false
        }
    }'

返回参数

参数	类型	描述	示例值
-	object
allowMergeRoles	array[integer]	允许合并的角色列表：40-管理员，30-开发者。	40, 30
allowMergeUserIds	array[string]	允许合并的用户 ID 列表。	123345678912345
allowMergeUsers	array	允许合并的用户列表。
-	object
avatarUrl	string	头像地址。	https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100
email	string	邮箱。	username@example.com
id	integer	数据库主键 ID（无业务意义）。	5240
name	string	用户名称。	codeup
userId	string	云效用户 ID（在 codeup 的 OpenAPI 中涉及到用户 ID 之处，均应使用该用户 ID）。	2344667212345561
username	string	用户名称（登录名）。	codeup-test
allowPushRoles	array[integer]	允许推送的角色列表：40-管理员，30-开发者。	40
allowPushUserIds	array[string]	允许推送用户 ID 列表。	19238
allowPushUsers	array	允许推送的用户列表。
-	object
avatarUrl	string	头像地址。	https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100
email	string	邮箱。	username@example.com
id	integer	数据库主键 ID（无业务意义）。	5240
name	string	用户名称。	codeup
userId	string	云效用户 ID（在 Codeup 的 OpenAPI 中涉及到用户 ID 之处，均应使用该用户 ID）。	2344667212345561
username	string	用户名称（登录名）。	codeup-test
branch	string	分支名称。	protectBranch
createdAt	string	创建时间。	2023-01-03T15:41:26+08:00
id	integer	保护分支规则 ID。	5240
matches	array[string]	匹配的分支列表。
mergeRequestSetting	object
allowMergeRequestRoles	array[integer]	允许合并请求的角色列表。	40
defaultAssignees	array	默认评审人列表。
-	object
avatarUrl	string	头像地址。	https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100
email	string	邮箱。	username@example.com
id	integer	数据库主键 ID（无业务意义）。	5240
name	string	用户名称。	codeup
userId	string	云效用户 ID（在 Codeup 的 OpenAPI 中涉及到用户 ID 之处，均应使用该用户 ID）。	2344667212345561
username	string	用户名称（登录名）。	codeup-test
isAllowSelfApproval	boolean	是否允许创建者通过代码评审。	true
isAllowSourceBranchPushUserApproval	boolean	是否允许源分支的提交者通过合并请求。	true
isRequireDiscussionProcessed	boolean	是否要求评审全部已解决。	true
isRequired	boolean	是否开启。	true
isResetApprovalWhenNewPush	boolean	是否在有推送时重置评审状态。	true
minimumApproval	integer	评审通过的最少人数，仅普通模式生效。	1
mrMode	string	评审模式：general - 普通模式, codeowner - CodeOwner 模式。	general
whiteList	string	评审文件白名单；输入文件路径，多行以换行符隔开，通配符请使用英文格式。	**.java
testSetting	object
checkCheckRunConfig	object	运行检查。
checkRunCheckItems	array	配置项列表。
-	object
id	string	写入人的 ID。	5240
name	string	check run 的名称。	测试流水线
required	boolean	是否作为卡点。	false
type	string	写入人类型：User。	User
checkCommitStatusConfig	object	提交状态。
commitStatusCheckItems	array	配置项列表。
-	object
context	string	三方提交状态的名称（以名称作为卡点的匹配项）。	""
required	boolean	是否作为卡点。	false
checkConfig	object	流水线检查。
checkItems	array	配置项列表。
-	object
isRequired	boolean	是否是卡点项。	false
pipelineId	integer	流水线 ID。	0
pipelineName	string	流水线名称。	""
checkTaskQualityConfig	object	代码检测任务。
bizNo	string	检测任务流水线号。	123456
enabled	boolean	是否开启。	false
message	string	描述信息。	test_task_quality
taskName	string	检测任务名称。	bz-task-quality
isRequired	boolean	是否开启。	false
updatedAt	string	更新时间。	2023-01-03T15:41:26+08:00

返回示例

{
    "allowMergeRoles": [
        40,
        30
    ],
    "allowMergeUserIds": [
        "123345678912345"
    ],
    "allowMergeUsers": [
        {
            "avatarUrl": "https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100",
            "email": "username@example.com",
            "id": 5240,
            "name": "codeup",
            "userId": "2344667212345561",
            "username": "codeup-test"
        }
    ],
    "allowPushRoles": [
        40
    ],
    "allowPushUserIds": [
        "19238"
    ],
    "allowPushUsers": [
        {
            "avatarUrl": "https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100",
            "email": "username@example.com",
            "id": 5240,
            "name": "codeup",
            "userId": "2344667212345561",
            "username": "codeup-test"
        }
    ],
    "branch": "protectBranch",
    "createdAt": "2023-01-03T15:41:26+08:00",
    "id": 5240,
    "matches": [
        ""
    ],
    "mergeRequestSetting": {
        "allowMergeRequestRoles": [
            40
        ],
        "defaultAssignees": [
            {
                "avatarUrl": "https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100",
                "email": "username@example.com",
                "id": 5240,
                "name": "codeup",
                "userId": "2344667212345561",
                "username": "codeup-test"
            }
        ],
        "isAllowSelfApproval": false,
        "isAllowSourceBranchPushUserApproval": false,
        "isRequireDiscussionProcessed": false,
        "isRequired": false,
        "isResetApprovalWhenNewPush": false,
        "minimumApproval": 0,
        "mrMode": "general",
        "whiteList": "**.java"
    },
    "testSetting": {
        "checkCheckRunConfig": {
            "checkRunCheckItems": [
                {
                    "id": "5240",
                    "name": "测试流水线",
                    "required": false,
                    "type": "User"
                }
            ]
        },
        "checkCommitStatusConfig": {
            "commitStatusCheckItems": [
                {
                    "context": "",
                    "required": false
                }
            ]
        },
        "checkConfig": {
            "checkItems": [
                {
                    "isRequired": false,
                    "pipelineId": 0,
                    "pipelineName": ""
                }
            ]
        },
        "checkTaskQualityConfig": {
            "bizNo": "123456",
            "enabled": false,
            "message": "test_task_quality",
            "taskName": "bz-task-quality"
        },
        "isRequired": false
    },
    "updatedAt": "2023-01-03T15:41:26+08:00"
}

错误码

访问错误码中心查看 API 相关错误码。