文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ V4/ Repository/ 获取项目下仓库列表
更新时间：2025-09-28 GMT+08:00
查看PDF
分享

获取项目下仓库列表

功能介绍

获取项目下仓库列表

调试

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

URI

GET /v4/projects/{project_id}/repositories

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目的32位uuid，项目唯一标识，通过查询项目列表接口查询项目列表获取。

取值范围：

字符串长度32。
表2 Query参数

参数

是否必选

参数类型

描述

search

否

String

参数解释：

仓库名称搜索关键字。

取值范围：

不涉及。

约束限制：

不涉及。

默认取值：

不涉及。

offset

否

Integer

参数解释：

偏移量，从0开始。

取值范围：

0-2147483647

默认取值：

0

limit

否

Integer

参数解释：

返回数量。

取值范围：

1-100

默认取值：

20

order_by

否

String

参数解释：

排序字段。

取值范围：

  • id，仓库ID。

  • name，仓库名称。

  • created_at，创建时间。

  • updated_at，更新时间。

约束限制：

不涉及。

默认取值：

updated_at。

默认取值：

updated_at

枚举值：

  • id

  • name

  • created_at

  • updated_at

sort

否

String

参数解释：

排序字段。

取值范围：

  • asc，升序。

  • desc，逆序。

约束限制：

不涉及。

默认取值：

desc。

默认取值：

desc

枚举值：

  • asc

  • desc

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

必传。

取值范围：

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

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of BasicRepositoryDto objects

仓库信息
表5 BasicRepositoryDto

参数

参数类型

描述

id

Integer

参数解释：

仓库ID

约束限制：

不涉及。

取值范围：

1-2147483647

name

String

参数解释：

仓库名称。

约束限制：

不涉及。

namespace

String

参数解释：

命名空间。

约束限制：

不涉及。

path

String

参数解释：

仓库路径。

约束限制：

不涉及。

develop_mode

String

参数解释：

开发模式。

枚举值：normal：合并请求模式；CR：变更请求模式。

约束限制：

不涉及。

visibility

String

参数解释：

仓库可见性。

枚举值：private：私有；internal：内部公开；public：公开。

约束限制：

不涉及。

security

String

参数解释：

安全级别。

枚举值：product_internal：项目内公开；tenant_internal：租户内公开。

约束限制：

不涉及。

name_with_namespace

String

参数解释：

包含命名空间的仓库名称。

约束限制：

不涉及。

archived

Boolean

参数解释：

是否归档。true：已归档；false：未归档。

约束限制：

不涉及。

status

String

参数解释：

仓库状态。

约束限制：

不涉及。

请求示例

无

响应示例

状态码：200

项目下仓库列表

[ {
  "id" : 2112041493,
  "name" : "test3",
  "namespace" : "3e1f6634946144c2b1ccb46fb8152b8f/test3",
  "path" : "test3",
  "develop_mode" : "normal",
  "visibility" : "private",
  "security" : "internal",
  "name_with_namespace" : "3e1f6634946144c2b1ccb46fb8152b8f / test3",
  "archived" : false,
  "status" : "0"
} ]

状态码

状态码

描述

200

项目下仓库列表

错误码

请参见错误码。

父主题： Repository

相关文档