更新时间:2025-07-30 GMT+08:00
分享

查询maven仓库列表

功能介绍

查询maven仓库列表

调用方法

请参见如何调用API

URI

GET /cloudartifact/v5/maven/list

表1 Query参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,可以从调用API处获取,也可以从控制台获取。获取方式请参考获取项目ID

约束限制:

只能由英文字母、数字组成,且长度为32个字符。

取值范围:

不涉及。

默认取值:

无。

default

Boolean

参数解释:

是否返回默认仓库。

约束限制:

不涉及。

取值范围:

true or false。

默认取值:

false。

policy

String

参数解释:

仓库类型:snapshot 或 release。

约束限制:

不涉及。

取值范围:

snapshot or releases。

默认取值:

不涉及。

repo_ids

String

参数解释:

仓库id,多个仓库id用英文逗号间隔。仓库id格式为{region}{domainId}{format}_{sequence}。可以从私有依赖库首页->仓库概览->仓库地址 url 中获取,最后两个"/"中间的字符串即为仓库id。

约束限制:

不涉及。

取值范围:

最大长度512。

默认取值:

不涉及。

access

String

参数解释:

权限过滤设置,允许过滤读(r)和读写(rw)权限。

约束限制:

不涉及。

取值范围:

r or rw。

默认取值:

r。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释:

请求成功、失败状态。

取值范围:

success:请求成功。

error:请求失败。

trace_id

String

参数解释:

请求id,当前请求唯一标识。

取值范围:

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

result

Array of RepositoryDOV5 objects

参数解释:

仓库列表。

取值范围:

不涉及。

表3 RepositoryDOV5

参数

参数类型

描述

status

String

参数解释:

仓库状态。

取值范围:

active:正常。

delete:删除。

disabled:无效。

view:私有库浏览者。

trash:废弃。

domain_id

String

参数解释:

租户id。

取值范围:

不涉及。

region

String

参数解释:

区域。

取值范围:

不涉及。

created_time

String

参数解释:

创建时间,时间格式:yyyy-MM-dd HH:mm:ss。

取值范围:

不涉及。

modified_time

String

参数解释:

修改时间,时间格式:yyyy-MM-dd HH:mm:ss。

取值范围:

不涉及。

created_user_id

String

参数解释:

创建人id。

取值范围:

不涉及。

created_user_name

String

参数解释:

创建人。

取值范围:

不涉及。

modified_user_id

String

参数解释:

修改人id。

取值范围:

不涉及。

modified_user_name

String

参数解释:

修改人。

取值范围:

不涉及。

repository_name

String

参数解释:

仓库名称。

取值范围:

不涉及。

format

String

参数解释:

制品类型。

取值范围:

maven|maven2|npm|go|pypi|rpm|composer|debian|conan|nuget|docker2|cocoapods|ohpm|generic|helm|conda。

type

String

参数解释:

仓库类型。

取值范围:

hosted:本地仓库。

remote:代理仓库。

virtual:聚合仓库。

description

String

参数解释:

仓库描述。

取值范围:

不涉及。

release

String

参数解释:

release仓库名称,release和snapshot至少二选一。

取值范围:

不涉及。

snapshot

String

参数解释:

snapshot仓库名称,release和snapshot至少二选一。

取值范围:

不涉及。

includes_pattern

String

参数解释:

路径包含规则。

取值范围:

不涉及。

excludes_pattern

String

参数解释:

路径排除规则。

取值范围:

不涉及。

share_right

String

参数解释:

共享权限级别。

取值范围:

PROJECT。

project_id

String

参数解释:

项目ID。

取值范围:

不涉及。

name

String

参数解释:

仓库id。

取值范围:

不涉及。

disable

Boolean

参数解释:

是否禁用。

取值范围:

不涉及。

policy

String

参数解释:

仓库策略。

取值范围:

release或snapshot。

npm

String

参数解释:

npm。

取值范围:

不涉及。

uri

String

参数解释:

uri。

取值范围:

不涉及。

repositories

String

参数解释:

repositories。

取值范围:

不涉及。

user_name

String

参数解释:

账号。

取值范围:

不涉及。

password

String

参数解释:

密码。

取值范围:

不涉及。

proxy

String

参数解释:

代理。

取值范围:

不涉及。

scope

Integer

参数解释:

范围。

取值范围:

不涉及。

url

String

参数解释:

地址。

取值范围:

不涉及。

tab_id

String

参数解释:

用于标记一对maven仓库(release、snapshot),相同的tab_id即为一对maven仓库。

取值范围:

不涉及。

display_name

String

参数解释:

展示的仓库名称。

取值范围:

不涉及。

snapshot_status

String

参数解释:

快照仓状态。

取值范围:

不涉及。

release_status

String

参数解释:

发布仓状态。

取值范围:

不涉及。

repository_ids

String

参数解释:

仓库id列表。

取值范围:

不涉及。

deployment_policy

String

参数解释:

覆盖策略。

取值范围:

不涉及。

parent_repo_name

String

参数解释:

父仓库名。

取值范围:

不涉及。

remote_url

String

参数解释:

代理仓地址。

取值范围:

不涉及。

remote_auth

String

参数解释:

代理仓认证。

取值范围:

不涉及。

pypi_registry_url

String

参数解释:

pypi索引代理地址。

取值范围:

不涉及。

default_deploy_repository

String

参数解释:

虚仓的默认仓库。

取值范围:

不涉及。

package_type

String

参数解释:

制品类型。

取值范围:

不涉及。

nexu_repo

Boolean

参数解释:

是否nexu仓库。

取值范围:

不涉及。

migrate_flag

Integer

参数解释:

迁移标识。

取值范围:

不涉及。

请求示例

查询maven仓库列表

https://{URL}/cloudartifact/v5/maven/list?project_id=e43d0c28dca0439b9d8651224ca30ccc&policy=release&access=r&repo_ids=xx-xxxxx-x_09d2ca2f5080d5b60f51c00ae5bad0a0_maven_1_100

响应示例

状态码:200

OK

{
  "status" : "success",
  "trace_id" : "ddfa39b9d5d34baa82b23a5b73faf15c",
  "result" : [ {
    "status" : "active",
    "region" : "xx-xxxxx-x",
    "name" : "xx-xxxxx-x_09d2ca2f5080d5b60f51c00ae5bad0a0_maven_1_100",
    "disable" : false,
    "format" : "maven2",
    "type" : "hosted",
    "policy" : "release",
    "description" : "",
    "snapshot" : null,
    "release" : null,
    "npm" : null,
    "uri" : null,
    "repositories" : null,
    "password" : null,
    "proxy" : null,
    "url" : "https://devrepo.devcloud.xx-xxxxx-x.ulanqab.huawei.com/artgalaxy/xx-xxxxx-x_09d2ca2f5080d5b60f51c00ae5bad0a0_maven_1_100/",
    "domain_id" : "09d2ca2f5080d5b60f51c00ae5bad0a0",
    "created_time" : "2023-09-22 16:33:00",
    "modified_time" : "2024-04-01 10:50:52",
    "created_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "created_user_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_id" : null,
    "modified_user_name" : null,
    "tab_id" : "09d2ca2f5080d5b60f51c00ae5bad0a0_tab_maven2_100",
    "repository_name" : "tttasda",
    "display_name" : "tttasda",
    "snapshot_status" : null,
    "release_status" : null,
    "project_id" : "e43d0c28dca0439b9d8651224ca30ccc",
    "includes_pattern" : "**/*",
    "excludes_pattern" : null,
    "repository_ids" : null,
    "deployment_policy" : null,
    "parent_repo_name" : null,
    "user_name" : null,
    "remote_url" : null,
    "pypi_registry_url" : null,
    "default_deploy_repository" : null,
    "remote_type" : null,
    "allow_anonymous" : null,
    "auto_clean_snapshot" : null,
    "snapshot_alive_days" : null,
    "max_unique_snapshots" : null,
    "share_right" : "PROJECT",
    "nexu_repo" : false,
    "migrate_flag" : 0,
    "obs_speed_bucket" : null,
    "associate_project" : null,
    "package_type" : "maven"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档