更新时间:2025-11-28 GMT+08:00
分享

查询项目列表

功能介绍

当开发团队成员需要了解仓库和项目的关联关系时,由于信息分散而难以快速获取,调用该接口可以快速查询项目列表信息,包含仓库和项目的关联关系,以便于仓库的管理和协作。

调用方法

请参见如何调用API

URI

GET /v5/maven/project/repository

表1 Query参数

参数

是否必选

参数类型

描述

search_name

String

参数解释

项目的名称,支持模糊查询。

约束限制

不涉及。

取值范围

最大200个字符。

默认取值

不涉及。

offset

Integer

参数解释

分页查询的起始位置。

约束限制

不涉及。

取值范围

0-2147483647

默认取值

0

limit

Integer

参数解释

分页查询每页的数据量。

约束限制

不涉及。

取值范围

1-2147483647

默认取值

10

repo_id

String

参数解释

仓库ID,格式为{region}_{domainId}_{format}_{sequence}。可以从制品仓库服务的“私有依赖库首页 > 仓库概览 > 仓库地址URL”中获取,最后两个“/”中间的字符串即为仓库ID。例如仓库地址:https://devrepo.devcloud.abcde.abc.xyz.com/artgalaxy/abcde_09d2ca2f5080d5b60f51c00ae5bad0a0_maven_2_50/,其中abcde_09d2ca2f5080d5b60f51c00ae5bad0a0_maven_2_50即为仓库ID。

约束限制

不涉及。

取值范围

仓库ID格式中的format支持以下取值:

  • npm

  • go

  • pypi

  • rpm

  • composer

  • maven

  • debian

  • conan

  • nuget

  • docker2

  • cocoapods

默认取值

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释

查询项目列表成功或失败的状态。

取值范围

  • success:查询项目列表成功。

  • error:查询项目列表失败。

trace_id

String

参数解释

请求ID,当前请求的唯一标识。

取值范围

数字及中划线(-)组成的字符串。

result

PrivilegeProjectInfoV5 object

参数解释

请求返回的结果,项目对象。

取值范围

不涉及。

表3 PrivilegeProjectInfoV5

参数

参数类型

描述

id

String

参数解释

项目的序号。

取值范围

不涉及。

name

String

参数解释

项目的名称。

取值范围

不涉及。

status

String

参数解释

项目的状态(该参数无返回值,请忽略)。

取值范围

不涉及。

project_id

String

参数解释

项目ID。

取值范围

不涉及。

created_time

String

参数解释

项目的创建时间。

取值范围

格式为yyyy-MM-dd HH:mm:ss。

repository_num

Integer

参数解释

仓库的数量。

取值范围

不涉及。

total

Integer

参数解释

项目的总数(该参数无返回值,请忽略)。

取值范围

不涉及。

repository_id

String

参数解释

仓库ID。

取值范围

不涉及。

region

String

参数解释

项目所属的区域。

取值范围

不涉及。

domain_id

String

参数解释

租户ID。

取值范围

不涉及。

ids

Array of strings

参数解释

项目的序号列表(该参数无返回值,请忽略)。

取值范围

不涉及。

total_records

Integer

参数解释

项目的总数。

取值范围

不涉及。

associated

Boolean

参数解释

请求参数中的仓库ID是否关联到本项目。

取值范围

  • true:关联到本项目。

  • false:未关联到本项目。

project_info

Array of PrivilegeProjectInfoV5 objects

参数解释

项目的信息。

取值范围

不涉及。

请求示例

查询项目列表。

https://{endpoint}/v5/maven/project/repository?search_name=子用户删除测试&repo_id=aa-bbbbb-c_09d2ca2f5080d5b60f51c00ae5bad0a0_maven_5_44&offset=0&limit=10

响应示例

状态码:200

查询项目管理对接列表成功。

{
  "status" : "success",
  "trace_id" : "143006-1760344958153-39922",
  "result" : {
    "id" : null,
    "name" : null,
    "status" : null,
    "total" : 1,
    "region" : null,
    "ids" : null,
    "associated" : false,
    "project_id" : null,
    "created_time" : null,
    "repository_num" : 0,
    "repository_id" : null,
    "domain_id" : null,
    "project_info" : [ {
      "id" : null,
      "name" : "子用户删除测试",
      "status" : null,
      "total" : 0,
      "region" : null,
      "ids" : null,
      "associated" : false,
      "project_id" : "b6c5c65138f24847acc3acaae9d009d8",
      "created_time" : "2025-08-27 16:56:11",
      "repository_num" : 1,
      "repository_id" : null,
      "domain_id" : null,
      "project_info" : null,
      "total_records" : 0
    } ],
    "total_records" : 1
  }
}

状态码

状态码

描述

200

查询项目管理对接列表成功。

错误码

请参见错误码

相关文档