本文导读

功能介绍
调试
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ V2Project/ 查询项目下的所有仓库

查询项目下的所有仓库

更新时间：2024-09-02 GMT+08:00

查看PDF

功能介绍

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。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

{
  "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

错误码

请参见错误码。

父主题： V2Project

上一篇：创建项目并fork仓库

下一篇：分支关联工作项

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问