文档首页/制品仓库 CodeArts Artifact/API参考/API/发布库版本管理/查询发布库版本列表 - ShowVersionList
更新时间：2026-01-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询发布库版本列表 - ShowVersionList

功能介绍

当发布库版本众多时，用户可根据项目ID分页查询对应发布库下的版本列表。该接口支持版本名称的模糊搜索。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

codeartsartifact:releaseRepo:read

Read

-

-

-

-

URI

GET /v5/{project_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

build_version

否

String

参数解释：

表示发布库版本的名称。

约束限制：

不涉及。

取值范围：

英文字母、数字、特殊字符支持中划线、下划线和英文句号，长度为1-128个字符。

默认取值：

不涉及。

offset

否

Integer

参数解释：

分页查询的起始位置。

约束限制：

不涉及。

取值范围：

0-10000000

默认取值：

0

limit

否

Integer

参数解释：

分页查询每页的数据量。

约束限制：

不涉及。

取值范围：

1-100

默认取值：

10

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释：

查询发布库版本列表成功或失败的状态。

取值范围：

  • success：查询发布库版本列表成功。

  • error：查询发布库版本列表失败。

trace_id

String

参数解释：

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

取值范围：

数字及中划线（-）组成的字符串。

result

Array of VersionListViewV5 objects

参数解释：

版本信息列表。

取值范围：

不涉及。

表4 VersionListViewV5

参数

参数类型

描述

category

String

参数解释：

发布库版本的状态。

取值范围：

  • test：测试包。

  • prod：发布包。

build_version

String

参数解释：

发布库版本的名称。

取值范围：

不涉及。

files_count

Integer

参数解释：

版本下的文件个数。

取值范围：

不涉及。

请求示例

根据项目ID分页查询对应发布库下的版本列表。

https://{URL}/v5/3fb31f5835b84781b136d83ad4122be9/versions?build_version=2025&offset=0&limit=10

响应示例

状态码：200

查询发布库版本列表成功。

{
  "status" : "success",
  "trace_id" : "6c0165219f5b45a5b0e63be190a18622",
  "result" : [ {
    "category" : "test",
    "build_version" : "20250709.2",
    "files_count" : 30
  }, {
    "category" : "test",
    "build_version" : "20250709.1",
    "files_count" : 20
  } ]
}

状态码

状态码

描述

200

查询发布库版本列表成功。

错误码

请参见错误码。