九游平台/ 代码托管 codearts repo/ api参考/ / / 创建项目、仓库
更新时间:2024-10-26 gmt 08:00

创建项目、仓库-九游平台

功能介绍

创建项目后,创建仓库组由后台生成方式 传入参数:仓库名、模板id、是否导入项目成员、归属项目

调试

您可以在中调试该接口,支持自动认证鉴权。api explorer可以自动生成sdk代码示例,并提供sdk代码示例调试功能。

uri

post /v2/projects/repositories

请求参数

表1 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

string

参数解释:

用户token。通过调用iam服务获取用户token接口获取(响应消息头中x-subject-token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

表2 请求body参数

参数

是否必选

参数类型

描述

import_members

integer

参数解释

是否导入项目成员。

约束限制

不涉及。

取值范围:

  • 0,不导入项目成员。
  • 1,导入项目成员。

默认取值:

0

project_name

string

参数解释

项目名称。

约束限制

必传。

取值范围:

可以输入英文大小写字母、数字、连字符、下划线,且必须以字母开头。

默认取值:

不涉及。

repo_name

string

参数解释

仓库名称。

约束限制

必传。

取值范围:

  • 以大小写字母、数字、下划线开头,可包含大小写字母、数字、中划线、下划线、英文句点,但不能以.git、.atom或.结尾。
  • 长度为1-256。

默认取值:

0

type

string

参数解释

项目类型,scrum。

约束限制

不涉及。

取值范围:

默认取值:

0

visibility_level

integer

参数解释

仓库可见性。

约束限制

不涉及。

取值范围:

  • 私有仓库:仓库仅对仓库成员可见,仓库成员可读写和访问仓库,取值为0
  • 公开仓库:
    1. 项目内成员只读仓库:仓库对项目内成员公开只读,并项目内成员可在项目下和代码组下的仓库列表中查看和搜索,取值为10
    2. 租户内成员只读仓库:仓库对租户内成员公开只读,并租户内成员可在项目下和代码组下的仓库列表中查看和搜索,取值为10
    3. 所有访客只读仓库:仓库对所有访客公开只读,并所有访客可在项目下和代码组下的仓库列表中查看和搜索,取值为20

默认取值:

0

external_project_info

externalkeymessage object

参数解释

第三方服务信息。

约束限制

不涉及。

表3 externalkeymessage

参数

是否必选

参数类型

描述

external_key_message

string

参数解释

第三方保存在代码托管的关键信息。

约束限制

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

external_service

string

参数解释

外部服务名称。

约束限制

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

响应参数

状态码: 200

表4 响应body参数

参数

参数类型

描述

error

error object

参数解释

响应错误。

result

projectrepository object

参数解释

响应结果。

status

string

参数解释

响应状态。

取值范围:

  • success,表示接口调用成功。
  • fail,表示接口调用失败。
表5 error

参数

参数类型

描述

code

string

参数解释

错误码。

取值范围:

请参见错误码

message

string

参数解释

错误信息。

取值范围:

字符串。

表6 projectrepository

参数

参数类型

描述

projectuuid

string

参数解释

项目id,获取方式请参见获取项目id

取值范围:

32位字符串。

repositoryuuid

string

参数解释

仓库uuid。

取值范围:

32位字符串。

请求示例

post https://{endpoint}/v2/projects/repositories
{
  "project_name" : "testworld",
  "repo_name" : "demotest1",
  "import_members" : "0",
  "visibility_level" : "20",
  "type" : "normal"
}

响应示例

状态码: 200

ok

{
  "result" : {
    "repositoryuuid" : "02637c34ba954ab5bd37ff9537fe05b4",
    "projectuuid" : "1aeda7a6070d4119b7d8b45e5641599b"
  },
  "status" : "success"
}

状态码

状态码

描述

200

ok

错误码

请参见错误码

相关文档

网站地图