九游平台/ 代码托管 codearts repo/ api参考/ / / 查询项目下的所有仓库
更新时间:2024-09-02 gmt 08:00

查询项目下的所有仓库-九游平台

功能介绍

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

调试

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

uri

get /v2/projects/{project_uuid}/repositories

表1 路径参数

参数

是否必选

参数类型

描述

project_uuid

string

参数解释

项目id,获取方式请参见获取项目id

约束限制

必传。

取值范围:

32位字符串。

默认取值:

不涉及。

表2 query参数

参数

是否必选

参数类型

描述

page_index

integer

参数解释

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

约束限制

不涉及。

取值范围:

1-2,147,483,647

默认取值:

1

page_size

integer

参数解释

每页条目数。

约束限制

不涉及。

取值范围:

1-100

默认取值:

20

search

string

参数解释

搜索关键字。

约束限制

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

请求参数

表3 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

string

参数解释:

用户token。通过调用iam服务获取用户token接口获取(响应消息头中x-subject-token的值)。

约束限制:

必传。

取值范围:

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

默认取值:

不涉及。

响应参数

状态码: 200

表4 响应body参数

参数

参数类型

描述

error

error object

参数解释

响应错误:

result

repolistinfov2 object

参数解释

响应结果

status

string

参数解释

响应状态

取值范围:

  • success,表示接口调用成功。
  • fail,表示接口调用失败。
表5 error

参数

参数类型

描述

code

string

参数解释

错误码。

取值范围:

请参见错误码

message

string

参数解释

错误信息。

取值范围:

字符串。

表6 repolistinfov2

参数

参数类型

描述

repositories

array of repoinfov2 objects

参数解释

仓库列表。

total

integer

参数解释

仓库总数。

取值范围:

1-2147483647

表7 repoinfov2

参数

参数类型

描述

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

参数解释

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

取值范围:

  • 1:是
  • 0:不是

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

参数解释

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

取值范围:

  • true:已收藏。
  • false:未收藏。

status

integer

参数解释

仓库状态。

取值范围:

  • 0:仓库正常创建成功。
  • 1:仓库创建中。
  • 2:创建失败。
  • 3:仓库冻结。
  • 4:仓库已经关闭。

updated_at

string

参数解释

更新时间。

取值范围:

字符串。

userrole

integer

参数解释

用户在仓库中的权限。

取值范围:

  • 20:只读成员
  • 30:普通成员
  • 40:管理员

visibility_level

integer

参数解释

可见范围。

取值范围:

  • 0,私有仓库
  • 20,公有仓库

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

错误码

请参见错误码

相关文档

网站地图