文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 变更管理/ 创建变更
更新时间：2025-01-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建变更

功能介绍

创建变更。

调用方法

请参见如何调用API。

URI

POST /v2/{cloudProjectId}/change-request/create

表1 路径参数

参数

是否必选

参数类型

描述

cloudProjectId

是

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

component_id

是

String

微服务ID

title

是

String

变更标题

type

否

String

变更类型，默认为code

workitem_ids

是

Array of strings

工作项ID

repos

是

Array of repos objects

变更代码仓信息
表3 repos

参数

是否必选

参数类型

描述

repo_id

是

String

Repo代码仓ID

http_url

是

String

代码仓HTTP地址

git_url

是

String

代码仓GIT地址

feature_branch

是

String

特性分支

main_branch

是

String

默认分支

delete_branch_after_released

是

Boolean

发布后是否删除特性分支

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

id

String

变更ID

component_id

String

微服务ID

status

String

状态

title

String

标题

repos

Array of repos objects

变更代码仓信息

workitem_ids

Array of strings

工作项ID

release_time

String

发布时间

creator_id

String

创建人ID

creator_name

String

创建人名称

create_time

String

创建时间

updater_id

String

更新人ID

updater_name

String

更新人名称

update_time

String

更新时间
表5 repos

参数

参数类型

描述

repo_id

String

Repo代码仓ID

http_url

String

代码仓HTTP地址

git_url

String

代码仓GIT地址

feature_branch

String

特性分支

main_branch

String

默认分支

delete_branch_after_released

Boolean

发布后是否删除特性分支

请求示例

POST https://{endpoint}/v2/2d09f712e9504b61b034cc8f40e475a8/change-request/create

{
  "component_id" : "f7ced2341b204d2b82c607c6f0de5b4a",
  "title" : "aaaaa",
  "type" : "code",
  "workitem_ids" : [ "2332711" ],
  "repos" : [ {
    "http_url" : "https://example.com/test00001/maven.git",
    "git_url" : "git@example.com:test00001/maven.git",
    "feature_branch" : "aaaaaa",
    "main_branch" : "master",
    "delete_branch_after_released" : false,
    "repo_id" : "804934"
  } ]
}

响应示例

状态码： 200

ok

{
  "id" : "495d94a305d4456f9a8a1efaaf2d34e0",
  "component_id" : "f7ced2341b204d2b82c607c6f0de5b4a",
  "status" : "developing",
  "title" : "aaaa",
  "repos" : [ {
    "repo_id" : "804934",
    "http_url" : "https://example.com/test00001/maven.git",
    "git_url" : "git@example.com/test00001/maven.git",
    "feature_branch" : "aaa",
    "main_branch" : "master",
    "delete_branch_after_released" : false
  } ],
  "workitem_ids" : [ "2332711" ],
  "release_time" : null,
  "creator_id" : "05d8ca972f114765a8984795a8aa4d41",
  "creator_name" : "p_test5",
  "create_time" : "1719217063",
  "updater_id" : "05d8ca972f114765a8984795a8aa4d41",
  "updater_name" : "p_test5",
  "update_time" : "1719217063"
}

状态码

状态码

描述

200

ok

错误码

请参见错误码。

父主题： 变更管理

相关文档