更新时间：2025-11-28 GMT+08:00
查询项目下的版本数量
功能介绍
当发布库版本众多时，用户可根据项目ID查询对应发布库的版本数量，以便于管理和跟踪不同版本的发布情况。该接口支持通过版本名称过滤。
调用方法
请参见如何调用API。
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 |
查询项目下的版本数量成功。 |
错误码
请参见错误码。
父主题： 发布库版本管理
