查询当前用户在本项目下的仓库
功能介绍
查询当前用户在本项目下的仓库,即当前用户为仓库成员的仓库列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/projects/{project_uuid}/repositories
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_uuid | 是 | String | 参数解释: 项目的32位UUID,项目唯一标识,通过查询项目列表接口查询项目列表获取。 约束限制: 不涉及。 取值范围: 32个字符组成的字符串。 默认取值 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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个字符组成的字符串。 默认取值: 不涉及 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度不超过20000个字符。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
error | Error object | 参数解释: 错误信息,当status为fail时,表示接口调用失败,该对象显示具体的错误信息。 取值范围: 不涉及。 |
result | RepoListInfoV2 object | 参数解释: 响应结果。 取值范围: 不涉及。 |
status | String | 参数解释: 响应状态。 取值范围: |
参数 | 参数类型 | 描述 |
|---|---|---|
repositories | Array of RepoInfoV2 objects | 参数解释: 表示查询到的仓库列表。 取值范围: 不涉及。 |
total | Integer | 参数解释: 该用户在该项目下的仓库数量。 取值范围: 0-2147483647。 取值范围: 0-2147483647 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 参数解释: 当前用户是否是该仓库的创建者。 取值范围: |
lfs_size | String | 参数解释: 仓库LFS使用量,保留2位小数。示例:50.00M、1.20G。 取值范围: 不涉及。 |
project_is_deleted | String | 参数解释: 项目是否被删除。 取值范围: |
project_uuid | String | 参数解释: 项目的32位UUID。 取值范围: |
repository_id | Integer | 参数解释: 仓库ID。 取值范围: 不涉及。 |
repository_name | String | 参数解释: 仓库名。 取值范围: 不涉及。 |
repository_size | String | 参数解释: 仓库总容量,保留2位小数。示例:50M、1.2G。 取值范围: 不涉及。 |
repository_uuid | String | 参数解释: 仓库UUID。 取值范围: 不涉及。 |
ssh_url | String | 参数解释: 使用ssh协议方式克隆仓库时所使用的地址。 取值范围: 不涉及。 |
star | Boolean | 参数解释: 当前用户是否收藏该仓库。 取值范围: |
status | Integer | 参数解释: 仓库状态。 取值范围: |
updated_at | String | 参数解释: 表示仓库的更新时间。时间格式:yyyy-MM-dd HH:mm:ss 取值范围: 不涉及。 |
userRole | Integer | 参数解释: 用户在仓库中的权限。 取值范围: |
visibility_level | Integer | 参数解释: 仓库可见性。 取值范围: |
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 |
错误码
请参见错误码。

