更新时间：2026-01-22 GMT+08:00
查询项目下的版本数量 - ShowProjectVersionsCount
功能介绍
当发布库版本众多时，用户可根据项目ID查询对应发布库的版本数量，以便于管理和跟踪不同版本的发布情况。该接口支持通过版本名称过滤。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。
授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
codeartsartifact:releaseRepo:read | Read | - | - | - | - |
URI
GET /v5/{project_id}/versions/count
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释： 项目ID，可以调用API获取，也可以从控制台获取，获取方式请参考项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
build_version | 否 | String | 参数解释： 发布库版本的名称。 约束限制： 不涉及。 取值范围： 英文字母、数字、特殊字符支持中划线、下划线和英文句号，长度为1-128个字符。 默认取值： 不涉及。 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
status | String | 参数解释： 查询项目下的版本数量成功或失败的状态。 取值范围：
|
trace_id | String | 参数解释： 请求ID，当前请求的唯一标识。 取值范围： 数字及中划线（-）组成的字符串。 |
result | ResultCount object | 参数解释： 查询结果。 取值范围： 不涉及。 |
请求示例
根据项目ID查询对应发布库文件的版本数量。
https://{URL}/v5/3fb31f5835b84781b136d83ad4122be9/versions/count?build_version=2025 响应示例
状态码：200
查询项目下的版本数量成功。
{
"status" : "success",
"trace_id" : "8b3c0530f950425d8d9d72c8d3d5ba05",
"result" : {
"count" : 2
}
} 状态码
状态码 | 描述 |
|---|---|
200 | 查询项目下的版本数量成功。 |
错误码
请参见错误码。
父主题：发布库版本管理
