文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ V2Project/ 查询当前用户在本项目下的仓库
更新时间:2025-08-20 GMT+08:00
分享

查询当前用户在本项目下的仓库

功能介绍

查询当前用户在本项目下的仓库,即当前用户为仓库成员的仓库列表。

调试

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

URI

GET /v2/projects/{project_uuid}/repositories

表1 路径参数

参数

是否必选

参数类型

描述

project_uuid

String

参数解释:

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

约束限制:

不涉及。

取值范围:

32个字符组成的字符串。

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

page_index

Integer

参数解释:

分页索引,从1开始计数。

约束限制:

不涉及。

取值范围:

1-2,147,483,647。

取值范围:

1-2147483647

默认取值:

1

page_size

Integer

参数解释:

每页条目数。

约束限制:

不涉及。

取值范围:

1-100

取值范围:

1-100

默认取值:

20

search

String

参数解释:

搜索关键字,支持通过仓库名和创建者用户名(IAM用户名)搜索,不支持创建者昵称。

约束限制:

不涉及。

取值范围:

0-128个字符组成的字符串。

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及。

取值范围:

字符串长度不超过20000个字符。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

error

Error object

参数解释:

错误信息,当status为fail时,表示接口调用失败,该对象显示具体的错误信息。

取值范围:

不涉及。

result

RepoListInfoV2 object

参数解释:

响应结果。

取值范围:

不涉及。

status

String

参数解释:

响应状态。

取值范围:

  • success,表示接口调用成功。

  • fail,表示接口调用失败。

表5 Error

参数

参数类型

描述

code

String

参数解释:

错误码。

取值范围:

请参见错误码。

message

String

参数解释:

错误信息。

取值范围:

不涉及。

表6 RepoListInfoV2

参数

参数类型

描述

repositories

Array of RepoInfoV2 objects

参数解释:

表示查询到的仓库列表。

取值范围:

不涉及。

total

Integer

参数解释:

该用户在该项目下的仓库数量。

取值范围:

0-2147483647。

取值范围:

0-2147483647

表7 RepoInfoV2

参数

参数类型

描述

created_at

String

参数解释:

表示仓库的创建时间。时间格式:yyyy-MM-dd HH:mm:ss

取值范围:

不涉及。

creator_name

String

参数解释:

创建者的用户名,当用户是租户的情况下,用户名和租户名相同。

取值范围:

不涉及。

domain_name

String

参数解释:

创建者的租户名。

取值范围:

不涉及。

group_name

String

参数解释:

代码组名称(克隆地址中域名后面仓库名前的一段 示例:git@repo.example.com:Demo2025/testword.git,示例中组名为Demo2025)。

取值范围:

2-255个字符组成的字符串。

https_url

String

参数解释:

使用https协议克隆仓库时所使用的地址。

取值范围:

不涉及。

iam_user_uuid

String

参数解释:

IAM用户ID。

取值范围:

不涉及。

is_owner

Integer

参数解释:

当前用户是否是该仓库的创建者。

取值范围:

  • 1,是创建者。

  • 0,不是创建者。

lfs_size

String

参数解释:

仓库LFS使用量,保留2位小数。示例:50.00M、1.20G。

取值范围:

不涉及。

project_is_deleted

String

参数解释:

项目是否被删除。

取值范围:

  • true,已删除。

  • false,未删除。

project_uuid

String

参数解释:

项目的32位UUID。

取值范围:

  • true,已删除。

  • false,未删除。

repository_id

Integer

参数解释:

仓库ID。

取值范围:

不涉及。

repository_name

String

参数解释:

仓库名。

取值范围:

不涉及。

repository_size

String

参数解释:

仓库总容量,保留2位小数。示例:50M、1.2G。

取值范围:

不涉及。

repository_uuid

String

参数解释:

仓库UUID。

取值范围:

不涉及。

ssh_url

String

参数解释:

使用ssh协议方式克隆仓库时所使用的地址。

取值范围:

不涉及。

star

Boolean

参数解释:

当前用户是否收藏该仓库。

取值范围:

  • true,已收藏。

  • false,未收藏。

status

Integer

参数解释:

仓库状态。

取值范围:

  • 0,仓库正常创建成功

  • 1,仓库创建中

  • 2,创建失败

  • 3,仓库冻结

  • 4,仓库已经关闭

updated_at

String

参数解释:

表示仓库的更新时间。时间格式:yyyy-MM-dd HH:mm:ss

取值范围:

不涉及。

userRole

Integer

参数解释:

用户在仓库中的权限。

取值范围:

  • null,该仓库的权限体系为权限2.0,无法获取用户在仓库中的权限。

  • 20,只读成员

  • 30,普通成员

  • 40,管理员

visibility_level

Integer

参数解释:

仓库可见性。

取值范围:

  • 0,私有。

  • 20,公开。

web_url

String

参数解释:

该仓库的首页地址。

取值范围:

不涉及。

请求示例

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

响应示例

状态码:200

OK

{
  "result" : {
    "total" : 14,
    "repositories" : {
      "repository_uuid" : "d0457f74cc5b43d989ded7248f71b4e5",
      "repository_id" : 468480,
      "repository_name" : "testword",
      "ssh_url" : "git@repo.example.com:Demo2025/testword.git",
      "https_url" : "https://repo.example.com/Demo2025/testword.git",
      "group_name" : "Demo2025",
      "web_url" : "https://console.example.com/repo/468480/home",
      "visibility_level" : 0,
      "created_at" : "2025-02-15 09:40:26",
      "updated_at" : "2025-02-15 09:40:26",
      "repository_size" : "0.06M",
      "lfs_size" : "0.00M",
      "creator_name" : "repo",
      "domain_name" : "repo",
      "star" : false,
      "status" : 0,
      "is_owner" : 1,
      "iam_user_uuid" : "a618e34bd5704be3ae3395dfede06041",
      "project_uuid" : "4838955a48e2492bbe44b31bc4c272f6",
      "project_is_deleted" : "false",
      "userRole" : null
    }
  },
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档