文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 查询制品源版本 - QueryArtifactVersions
更新时间:2025-12-10 GMT+08:00
分享

查询制品源版本 - 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参数

参数

参数类型

描述

data

Object

参数解释

数据项。

取值范围

不涉及。

total

AnyType

参数解释

总数。

取值范围

大于等于0。

表4 data

参数

参数类型

描述

type

String

参数解释

类型。

取值范围

  • generic:软件发布库。

  • docker:Docker库。

name

String

参数解释

软件包名称。

取值范围

1到128位字符。

version

String

参数解释

软件包版本序列。

取值范围

1到32位字符。

branch

String

参数解释

构建分支。

取值范围

1到32位字符。

created_time

String

参数解释

创建时间。

取值范围

日期时间格式。

parent_id

String

参数解释

任务父级ID。

取值范围

32位字符。

请求示例

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

错误码

请参见错误码

相关文档