MergeChangeRequest - 合并合并请求_云效(Apsara Devops)-阿里云帮助中心

合并合并请求。

适用版本

企业标准版

服务接入点与授权信息

获取服务接入点，替换 API 请求语法中的 <domain> ：服务接入点（domain）。
获取个人访问令牌，具体操作，请参见获取个人访问令牌。
产品
资源
所需权限
代码管理
合并请求
读写

请求语法

POST https://{domain}/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/changeRequests/{localId}/merge

请求头

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

请求参数

参数	类型	位置	是否必填	描述	示例值
organizationId	string	path	是	组织 ID。	60de7a6852743a5162b5f957
repositoryId	string	path	是	代码库 ID 或者 URL-Encoder 编码的全路径。	2835387 或 codeup-org-id%2Fcodeup-demo
localId	integer	path	是	局部 ID。	1
-	object	body	否
mergeMessage	string	body	否	合并提交信息。	""
mergeType	string	body	否	合并类型：ff-only - fast-forward-only 合并方式；no-fast-forward - 普通合并方式；squash - 压缩合并方式；rebase - rebase 合并方式。	no-fast-forward
removeSourceBranch	boolean	body	否	是否在合并后删除源分支。	false

请求示例

curl -X 'POST' \
  'https://test.rdc.aliyuncs.com/oapi/v1/codeup/organizations/{organizationId}/repositories/{repositoryId}/changeRequests/{localId}/merge' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "mergeMessage": "",
        "mergeType": "no-fast-forward",
        "removeSourceBranch": false
    }'

返回参数

参数	类型	描述	示例值
-	object
ahead	integer	源分支领先目标分支的 commit 数量。	1
allRequirementsPass	boolean	是否所有卡点项通过。	false
author	object	用户信息。
avatar	string	用户头像地址。	https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100
email	string	用户邮箱。	username@example.com
name	string	用户名称。	test-review-user
state	string	用户状态：active - 激活可用；blocked - 阻塞暂不可用。	active
userId	string	云效用户 ID。	62c795c9cf*****b468af8
username	string	用户登录名。	root-test-review-user
behind	integer	目标分支领先源分支的 commit 数量。	1
canRevertOrCherryPick	boolean	是否能 Revert 或者 CherryPick。	true
conflictCheckStatus	string	冲突检测状态：CHECKING - 检测中；HAS_CONFLICT - 有冲突；NO_CONFLICT - 无冲突；FAILED - 检测失败。	NO_CONFLICT
createFrom	string	创建来源：WEB - 页面创建；COMMAND_LINE - 命令行创建。	WEB
createTime	string	创建时间。	2023-05-30T02:53:36Z
description	string	描述。	描述信息的具体内容
detailUrl	string	合并请求详情地址。	xxx
hasReverted	boolean	是否 Revert 过。	false
localId	integer	局部 ID。	1
mergedRevision	string	合并版本（提交 ID），仅已合并状态才有值。	1a072f5367c21f9de3464b8c0ee8546e47764d2d
mrType	string	合并请求类型：CODE_REVIEW - 代码评审；REF_REVIEW - 分支标签评审。	CODE_REVIEW
projectId	integer	代码库 ID。	2369234
reviewers	array	评审人列表。
-	object
avatar	string	用户头像地址。	https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100
email	string	用户邮箱。	username@example.com
hasCommented	boolean	是否已经评论过。	true
hasReviewed	boolean	是否评审过。	false
name	string	用户名称。	test-codeup
reviewOpinionStatus	string	评审意见：PASS - 通过；NOT_PASS - 不通过。	NOT_PASS
reviewTime	string	评审时间。	2023-05-30T02:53:36Z
state	string	用户状态：active - 激活可用；blocked - 阻塞暂不可用。	active
userId	string	云效用户 ID。	62c795c9cf*****b468af8
username	string	用户登录名。	root-test-codeup
sourceBranch	string	源分支。	test-merge-request
sourceCommitId	string	源提交 ID，当 createFrom=COMMAND_LINE 时，有值。
sourceProjectId	integer	源库 ID。	2369234
sourceRef	string	源提交引用，当 createFrom=COMMAND_LINE 时，有值。
status	string	合并请求状态：UNDER_DEV - 开发中；UNDER_REVIEW - 评审中；TO_BE_MERGED - 待合并；CLOSED - 已关闭；MERGED - 已合并。	UNDER_REVIEW
subscribers	array	订阅人列表。
-	object	用户信息。
avatar	string	用户头像地址。	https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100
email	string	用户邮箱。	username@example.com
name	string	用户名称。	test-codeup
state	string	用户状态：active - 激活可用；blocked - 阻塞暂不可用。	active
userId	string	云效用户 ID。	62c795c9cf*****b468af8
username	string	用户登录名。	root-test-codeup
supportMergeFastForwardOnly	boolean	是否支持 fast-forward-only。	false
targetBranch	string	目标分支。	master
targetProjectId	integer	目标库 ID。	2369234
targetProjectNameWithNamespace	string	目标库名称（含完整父路径）。	orgId / test-group / test-target-repo（斜杠两侧有空格）
targetProjectPathWithNamespace	string	目标库路径（含完整父路径）。	orgId/test-group/test-target-repo
title	string	标题。	test-合并请求标题
totalCommentCount	integer	总评论数。	2
unResolvedCommentCount	integer	未解决评论数。	1
updateTime	string	更新时间。	2023-05-30T02:53:36Z
webUrl	string	页面地址。	xxx

返回示例

{
    "ahead": 1,
    "allRequirementsPass": false,
    "author": {
        "avatar": "https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100",
        "email": "username@example.com",
        "name": "test-review-user",
        "state": "active",
        "userId": "62c795c9cf*****b468af8",
        "username": "root-test-review-user"
    },
    "behind": 1,
    "canRevertOrCherryPick": false,
    "conflictCheckStatus": "NO_CONFLICT",
    "createFrom": "WEB",
    "createTime": "2023-05-30T02:53:36Z",
    "description": "描述信息的具体内容",
    "detailUrl": "xxx",
    "hasReverted": false,
    "localId": 1,
    "mergedRevision": "1a072f5367c21f9de3464b8c0ee8546e47764d2d",
    "mrType": "CODE_REVIEW",
    "projectId": 2369234,
    "reviewers": [
        {
            "avatar": "https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100",
            "email": "username@example.com",
            "hasCommented": true,
            "hasReviewed": false,
            "name": "test-codeup",
            "reviewOpinionStatus": "NOT_PASS",
            "reviewTime": "2023-05-30T02:53:36Z",
            "state": "active",
            "userId": "62c795c9cf*****b468af8",
            "username": "root-test-codeup"
        }
    ],
    "sourceBranch": "test-merge-request",
    "sourceCommitId": "",
    "sourceProjectId": 2369234,
    "sourceRef": "",
    "status": "UNDER_REVIEW",
    "subscribers": [
        {
            "avatar": "https://tcs-devops.aliyuncs.com/thumbnail/112afcb7a6a35c3f67f1bea827c4/w/100/h/100",
            "email": "username@example.com",
            "name": "test-codeup",
            "state": "active",
            "userId": "62c795c9cf*****b468af8",
            "username": "root-test-codeup"
        }
    ],
    "supportMergeFastForwardOnly": false,
    "targetBranch": "master",
    "targetProjectId": 2369234,
    "targetProjectNameWithNamespace": "orgId / test-group / test-target-repo（斜杠两侧有空格）",
    "targetProjectPathWithNamespace": "orgId/test-group/test-target-repo",
    "title": "test-合并请求标题",
    "totalCommentCount": 2,
    "unResolvedCommentCount": 1,
    "updateTime": "2023-05-30T02:53:36Z",
    "webUrl": "xxx"
}

错误码

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

产品	资源	所需权限
代码管理	合并请求	读写