文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 查询制品源版本 - QueryArtifactVersions
更新时间：2025-11-25 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询制品源版本 - QueryArtifactVersions

功能介绍

查询制品源的具体版本号

调用方法

请参见如何调用API。

URI

GET /v2/{cloud_project_id}/artifact/versions

表1 路径参数

参数

是否必选

参数类型

描述

cloud_project_id

是

String

参数解释：

CodeArts项目的32位UUID，项目唯一标识。

约束限制：

不涉及。

取值范围：

32位字符。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

query

否

String

参数解释：

模糊查询。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

page_index

否

Integer

参数解释：

分页查询页码数。

约束限制：

不涉及。

取值范围：

大于0。

默认取值：

1。

page_size

否

Integer

参数解释：

每页数量。

约束限制：

不涉及。

取值范围：

大于0。

默认取值：

10。

parent_id

否

String

参数解释：

制品源目录id，作为制品仓目录的唯一标识。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

metadata_type

否

String

参数解释：

制品源类型。

约束限制：

不涉及。

取值范围：

  • generic：软件发布库。

  • docker：Docker库。

默认取值：

不涉及。

name

否

String

参数解释：

制品源名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

repo_branch

否

String

参数解释：

代码仓的分支。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

参数解释：

错误信息，接口正常无报错时不返回error字段。

取值范围：

不涉及。

result

Object

参数解释：

返回结果。

取值范围：

不涉及。

status

String

参数解释：

状态值。

取值范围：

不涉及。
表4 ErrorInfo

参数

参数类型

描述

code

String

参数解释：

错误码。

取值范围：

不涉及。

message

String

参数解释：

错误信息。

取值范围：

不涉及。

请求示例

GET https://{endpoint}/v2/5c8305fa19154cabbb7f022a710f0ace/artifact/versions?name=&page_index=1&page_size=10&parent_id=&repo_branch=&query=&metadata_type=generic&_=1763891479324

响应示例

状态码：200

OK

{
  "data" : [ {
    "type" : "generic",
    "name" : "javaMavenDemo-1.0.jar",
    "version" : "20251022.1",
    "branch" : "master",
    "created_time" : "2025-10-22 07:07:43",
    "parent_id" : "42c582eb46044ead9858fec1e1926ebc"
  } ],
  "total" : 1
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 流水线管理

相关文档