文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ Project/ 获取项目下所有仓库信息
更新时间:2025-08-20 GMT+08:00
分享

获取项目下所有仓库信息

功能介绍

获取仓库列表 模糊查询支持范围,如果未传入project_id,则支持按仓库名或项目名模糊查询,否则,只按仓库名模糊匹配。

调试

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

URI

GET /v1/projects/{project_uuid}/repositories

表1 路径参数

参数

是否必选

参数类型

描述

project_uuid

String

参数解释

项目ID,获取方式请参见获取项目ID约束限制:

不涉及。

取值范围:

只能由数字和字母组成,且长度为32个字符。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

page_index

Integer

参数解释

分页索引。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

1

page_size

Integer

参数解释

每页条目数。

约束限制:

不涉及。

取值范围:

1-100

默认取值:

20

search

String

参数解释

搜索关键字。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

长度为[1,100000]个字符。

默认取值:

不涉及。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

error

Error object

参数解释

响应错误

取值范围:

不涉及

result

RepoListInfo object

参数解释

响应结果

取值范围:

不涉及

status

String

参数解释

响应状态

取值范围:

  • success,表示接口调用成功。
  • failed,表示接口调用失败。
表5 Error

参数

参数类型

描述

code

String

参数解释

错误码

取值范围:

符合错误码格式字符串,长度[0,100]。

message

String

参数解释

错误信息

取值范围:

不涉及

表6 RepoListInfo

参数

参数类型

描述

repositorys

Array of RepoInfo objects

参数解释

仓库列表

取值范围:

不涉及

total

Integer

参数解释

仓库总数

取值范围:

不涉及

表7 RepoInfo

参数

参数类型

描述

createAt

String

参数解释

创建时间

取值范围:

不涉及

groupName

String

参数解释

仓库组名(克隆地址中域名后面仓库名前的一段 示例:git@repo.example.com:Demo00228/testword.git 组名:Demo00228)

取值范围:

不涉及

httpUrl

String

参数解释

仓库https url

取值范围:

不涉及

id

String

参数解释

仓库uuid

取值范围:

32位字符串

name

String

参数解释

仓库名

取值范围:

不涉及

projectId

String

参数解释

项目ID

取值范围:

32位字符串

projectIsDelete

String

项目是否被删除

repoId

String

参数解释

仓库ID

取值范围:

1-40

sshUrl

String

参数解释

仓库ssh url

visibilityLevel

Integer

参数解释

是否可见:0私有仓库,20公有仓库

取值范围:

  • 0 私有仓
  • 20 公开仓

webUrl

String

参数解释

仓库web url

取值范围:

不涉及

请求示例

GET https://{endpoint}/v1/projects/{project_uuid}/repositories

响应示例

状态码: 200

OK

{
  "result" : {
    "total" : 1,
    "repositorys" : [ {
      "id" : "d0457f74cc5b43d989ded7248f71b4e5",
      "repoId" : "468480",
      "name" : "CreatRepository_2qD5i",
      "sshUrl" : "git@repo.example.com:Demo00228/CreatRepository_2qD5i.git",
      "httpUrl" : "https://repo.example.com/Demo00228/CreatRepository_2qD5i.git",
      "groupName" : "Demo00228",
      "webUrl" : "https://repo.example.com/repo/468480/home",
      "visibilityLevel" : 0,
      "createAt" : "2019-10-15 09:40:26",
      "projectId" : "4838955a48e2492bbe44b31bc4c272f6",
      "projectIsDelete" : "false"
    } ],
    "status" : "success"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档