查询项目下的所有仓库
功能介绍
获取仓库列表，模糊查询支持范围，如果未传入project uuid，则支持按仓库名或项目名模糊查询，否则，只按仓库名模糊匹配。
URI
GET /v2/projects/{project_uuid}/repositories
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_uuid |
是 |
String |
参数解释： 项目ID，获取方式请参见获取项目ID。 约束限制： 必传。 取值范围: 32位字符串。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
page_index |
否 |
Integer |
参数解释： 分页索引，从1开始计数。 约束限制： 不涉及。 取值范围: 1-2,147,483,647 默认取值: 1 |
|
page_size |
否 |
Integer |
参数解释： 每页条目数。 约束限制： 不涉及。 取值范围: 1-100 默认取值: 20 |
|
search |
否 |
String |
参数解释： 搜索关键字。 约束限制： 不涉及。 取值范围: 字符串。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
Error object |
参数解释： 响应错误: |
|
result |
RepoListInfoV2 object |
参数解释： 响应结果 |
|
status |
String |
参数解释： 响应状态 取值范围:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
repositories |
Array of RepoInfoV2 objects |
参数解释： 仓库列表。 |
|
total |
Integer |
参数解释： 仓库总数。 取值范围: 1-2147483647 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
参数解释： 创建时间。 取值范围: 字符串。 |
|
creator_name |
String |
参数解释： 创建者的用户名，当用户是租户，用户名和租户名一样。 取值范围: 字符串。 |
|
domain_name |
String |
参数解释： 创建者的租户名。 取值范围: 字符串。 |
|
group_name |
String |
参数解释： 仓库组名(克隆地址中域名后面仓库名前的一段。 示例：git@repo.alpha.devcloud.test.com:Demo00228/testword.git 组名：Demo00228 )。 取值范围: 字符串。 |
|
https_url |
String |
参数解释： 使用HTTPS克隆仓库时所使用的URL。 取值范围: 字符串。 |
|
iam_user_uuid |
String |
参数解释： 用户的IAM User UUID。 取值范围: 字符串。 |
|
is_owner |
Integer |
参数解释： 当前用户是否是仓库的创建者。 取值范围:
|
|
lfs_size |
String |
参数解释： 仓库LFS容量，单位为M，当容量大于1024M，单位为G。 取值范围: 字符串。 |
|
project_is_deleted |
String |
参数解释： 项目是否被删除。 取值范围: 字符串。 |
|
project_uuid |
String |
参数解释： 项目ID，获取方式请参见获取项目ID。 取值范围: 字符串。 |
|
repository_id |
Integer |
参数解释： 仓库主键ID。 取值范围: 1-2147483647 |
|
repository_name |
String |
参数解释： 仓库名称。 取值范围: 字符串。 |
|
repository_size |
String |
参数解释： 仓库总容量=仓库LFS容量 +Git库容量，单位为M，当容量大于1024M，单位为G。 取值范围: 字符串。 |
|
repository_uuid |
String |
参数解释： 仓库UUID(由CreateRepository接口返回)。 取值范围: 字符串。 |
|
ssh_url |
String |
参数解释： 使用SSH方式克隆仓库时所使用的URL。 取值范围: 字符串。 |
|
star |
Boolean |
参数解释： 当前用户是否收藏该仓库。 取值范围:
|
|
status |
Integer |
参数解释： 仓库状态。 取值范围:
|
|
updated_at |
String |
参数解释： 更新时间。 取值范围: 字符串。 |
|
userRole |
Integer |
参数解释： 用户在仓库中的权限。 取值范围:
|
|
visibility_level |
Integer |
参数解释： 可见范围。 取值范围:
|
|
web_url |
String |
参数解释： web url 路径，访问它将跳转至仓库详情页。 取值范围: 字符串。 |
请求示例
GET https://{endpoint}/v2/projects/{project_uuid}/repositories响应示例
状态码： 200
OK
{
"result" : {
"total" : 14,
"repositories" : {
"repository_uuid" : "d0457f74cc5b43d989ded7248f71b4e5",
"repository_id" : 468480,
"repository_name" : "CreatRepository_2qD5i",
"ssh_url" : "git@repo.test.com:Demo00228/CreatRepository_2qD5i.git",
"https_url" : "https://test.com/Demo00228/CreatRepository_2qD5i.git",
"group_name" : "Demo00228",
"web_url" : "https://test.com/repo/468480/home",
"visibility_level" : 0,
"created_at" : "2019-10-15 09:40:26",
"updated_at" : "2019-10-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 |
错误码
请参见错误码。
