创建项目并创建fork仓库
功能介绍
创建项目并根据源仓库创建fork仓库。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/projects/repositories/fork
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
import_members |
否 |
Integer |
参数解释: 是否导入项目成员。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
project_name |
是 |
String |
参数解释: 项目名称。 约束限制: 可以输入英文大小写字母、数字、连字符、下划线,且必须以字母开头。 取值范围: 不涉及。 默认值取值: 不涉及。 |
|
repo_name |
是 |
String |
参数解释: 仓库名称。 约束限制: 可以输入英文大小写字母、数字、连字符、下划线,且必须以字母开头。 取值范围: 不涉及。 默认值取值: 2-128 |
|
template_id |
是 |
String |
参数解释: 源仓库ID,可通过查询用户所有仓库接口查询仓库列表获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认值取值: 不涉及。 |
|
type |
否 |
String |
参数解释: 项目类型。 约束限制: 不涉及。 取值范围: scrum,Scrum类型项目。 默认值取值: scrum |
|
visibility_level |
否 |
Integer |
参数解释: 仓库可见性。 约束限制: 不涉及。 取值范围:
默认取值: 0 |
|
external_project_info |
否 |
ExternalKeyMessage object |
参数解释: 第三方服务信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认值取值: 不涉及。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
Error object |
参数解释: 响应错误。 取值范围: 不涉及。 |
|
result |
ProjectRepository object |
参数解释: 响应结果。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 响应状态。 取值范围:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 错误码。 取值范围: 符合错误码格式字符串,长度[0,100]。 |
|
message |
String |
参数解释: 错误信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
projectUuid |
String |
参数解释: 项目ID,获取方式请参见获取项目ID。 取值范围: 由数字和字母组成,且长度为32个字符。 |
|
repositoryUuid |
String |
参数解释: 仓库UUID。 取值范围: 由数字和字母组成,且长度为32个字符。 |
请求示例
POST https://{endpoint}/v2/projects/{project_uuid}/repositories/fork
{
"project_name" : "testworld",
"repo_name" : "demotest1",
"template_id" : 453489,
"import_members" : 0,
"visibility_level" : 20,
"type" : "normal"
}
响应示例
状态码: 200
OK
{
"result" : {
"repositoryUuid" : "9a780fd55cd64333b668ba26132629d2",
"projectUuid" : "278a03286efe45c6b788122bfc166976"
},
"status" : "success"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。