GitSettings

更新保护分支规则。Update branch protection rule.

更新指定的保护分支规则配置。需要仓库 Master 权限。支持修改匹配模式、合并要求、推送管控等所有规则字段。 Update the configuration of a branch protection rule. Requires Master permission. Supports modifying all rule fields including match pattern, merge requirements, and push restrictions. 访问令牌调用此接口需包含以下权限。Required permissions for access token. repo-manage:rw

patch/{repo}/-/settings/branch-protections/{id}

Request

  • Base URL: https://api.cnb.cool (the document declares no server; this is the origin it was published from)
  • URL: https://api.cnb.cool/{repo}/-/settings/branch-protections/{id}
  • Auth: API key in header Authorization

Path parameters

repostring required

不带.git后缀的仓库名称。格式：组织名称/仓库名称。Repository name without .git suffix. Format: org/repo.

idstring required

保护分支规则唯一标识符。Branch protection rule unique identifier.

Request body

allow_creationboolean

是否允许所有人创建保护分支。Whether all users can create protected branches.

allow_deletionsboolean

是否允许所有人删除保护分支。Whether all users can delete protected branches.

allow_force_pushesboolean

是否允许所有人强制推送。Whether all users can force push.

allow_master_creationboolean

是否仅允许仓库管理员及负责人创建保护分支。Only admins/owners can create protected branches.

allow_master_deletionsboolean

是否仅允许仓库管理员及负责人删除保护分支。Only admins/owners can delete protected branches.

allow_master_force_pushesboolean

是否仅允许仓库管理员及负责人强制推送。Whether only repo admins and owners can force push.

allow_master_manual_mergeboolean

是否允许仓库管理员及负责人手动合并到目标分支。Admins/owners can manually merge to target branch.

allow_master_pushesboolean

是否仅允许仓库管理员及负责人推送代码到保护分支中。Only admins/owners can push to protected branches.

allow_pushesboolean

是否允许所有人推送代码到保护分支中。Whether all users can push to protected branches.

forbid_approve_pull_created_by_own_npcboolean
idstring

保护分支规则唯一标识符。Protected branch rule unique identifier.

required_approved_review_countinteger

需要的代码评审者数量。格式：评审者数量 ∈ [1,5]。Required reviewers count. ∈ [1,5].

required_approved_review_ratiointeger

需要的评审通过率。格式：通过率 ∈ [1, 100]。Required approval rate. ∈ [1, 100].

required_linear_historyboolean

是否仅允许线性提交。Whether only linear commits are allowed.

required_master_approveboolean

是否需至少一个仓库管理员批准。Whether at least one repo admin approval is required.

required_must_auto_mergeboolean

是否仅允许自动合并。Whether only auto-merge is allowed.

required_must_push_via_pull_requestboolean

是否必须通过合并请求推送代码到此规则匹配分支中。Push must be via merge requests.

required_pull_request_reviewsboolean

保护分支的合并请求是否需要代码评审。Code review required for merge requests.

required_status_checksboolean

是否需要通过状态检查。Whether status checks are required.

rulestring

保护分支规则名称，支持通配符。Protected branch rule name. Supports wildcards.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.