# 查询制品源版本 - QueryArtifactVersions
#### 功能介绍
查询制品源的具体版本号
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-pipeline/pipeline_03_0006.html)。
#### URI
GET /v2/{cloud_project_id}/artifact/versions
表1路径参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| cloud_project_id | 是    | String | **参数解释**： CodeArts项目的32位UUID，项目唯一标识。 **约束限制**： 不涉及。 **取值范围**： 32位字符。 **默认取值**： 不涉及。 |
   
表2Query参数 
| 参数            | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| 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。 |
   
表4data 
| 参数           | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pipeline/ErrorCode.html)。