文档首页/ 代码托管 CodeArts Repo/ API参考（联盟区域）/ API/ Repository/ 创建仓库
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

创建仓库

功能介绍

用指定的名称在指定项目上创建仓库。传入参数：仓库名、模板id、是否导入项目成员、归属项目

URI

POST /v1/repositories

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表2 请求Body参数

参数

是否必选

参数类型

描述

import_members

否

Integer

是否导入项目成员，取值范围：0->不导入项目成员，1->导入项目成员

name

是

String

仓库名称，取值范围：可以输入英文大小写字母、数字、连字符、下划线，且必须以字母开头

project_uuid

是

String

指定项目ID，获取方式请参见获取项目ID。

最小长度：32

最大长度：32

template_id

否

String

复制模板的ID

visibility_level

否

Integer

仓库状态，取值范围：0->私有，20->公开只读

import_url

否

String

模板仓库的https地址的base64加密

description

否

String

仓库描述信息

gitignore_id

否

String

根据编程语言生成.gitignore文件

license_id

否

Integer

许可证id

enable_readme

否

Integer

是否允许生成README文件

caller

否

String

调用者

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

error

Error object

响应错误

result

Repository object

响应结果

status

String

响应状态
表4 Error

参数

参数类型

描述

code

String

错误码

message

String

错误信息
表5 Repository

参数

参数类型

描述

repository_uuid

String

创建仓库的UUID

最小长度：32

最大长度：32

请求示例

POST https://{endpoint}/v1/repositories

{
	"project_uuid": "4838955a48e2492bbe44b31bc4c272f6", 
	"name": "demotest1", 
	"import_members": "0", 
	"visibility_level": "20", 
 }

响应示例

状态码： 200

OK

{
  "result" : {
    "repository_uuid" : "d161fd00d9194816a455cb3c1d6a783e"
  },
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： Repository