文档首页/ 制品仓库 CodeArts Artifact/ API参考/ API/ 发布库版本管理/ 查询一个项目下所有文件的最新版本
更新时间:2025-07-10 GMT+08:00
分享

查询一个项目下所有文件的最新版本

功能介绍

查询一个项目下所有文件的最新版本

调用方法

请参见如何调用API

URI

GET /devreposerver/v5/{project_id}/files/version

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID,对应"需求管理 CodeArts Req"项目唯一标识,私有依赖库首页地址栏url https://{host}/cloudartifact/project/{project_id}/repository中project_id变量的值。

约束限制

字符串长度32。

取值范围

不涉及。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

name

String

参数解释

name。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

sort_by

String

参数解释

sort_by。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

sort_dir

String

参数解释

sort_dir。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

offset

Integer

参数解释

offset。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

limit

Integer

参数解释

limit。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释:

请求成功、失败状态。

取值范围:

success:请求成功。

error:请求失败。

trace_id

String

参数解释:

请求id,当前请求唯一标识。

取值范围:

数字及中划线(-)组成的字符串。

result

Array of VersionViewVoV5 objects

参数解释:

最新版本列表。

取值范围:

不涉及。

表4 VersionViewVoV5

参数

参数类型

描述

id

String

参数解释:

id。

取值范围:

不涉及。

project_id

String

参数解释:

项目id。

取值范围:

不涉及。

file_id

String

参数解释:

文件id。

取值范围:

不涉及。

name

String

参数解释:

文件名。

取值范围:

不涉及。

path

String

参数解释:

文件路径。

取值范围:

不涉及。

请求示例

查询一个项目下所有文件的最新版本

https://{URL}/devreposerver/v5/f132b62084774001b84c294c0eef27f2/files/version

响应示例

状态码:200

OK

{
  "status" : "success",
  "trace_id" : "7ca22127d0d544bebdea0115b42afa57",
  "result" : [ {
    "status" : null,
    "region" : null,
    "domain_id" : null,
    "created_time" : null,
    "modified_time" : 1747127485000,
    "created_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "created_user_name" : "devcloud_devcloud_y00226182_05",
    "created_user_nick_name" : "仓库小能手",
    "created_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "modified_user_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_nick_name" : "仓库小能手",
    "modified_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "id" : "0cd7f15890d84b91a27678e363ef151d",
    "project_id" : "f132b62084774001b84c294c0eef27f2",
    "file_id" : "2487edb497b44a28b07164dbd6689132",
    "name" : "_maven.repositories",
    "path" : "/11/",
    "size" : "0.0B",
    "version" : "latest",
    "version_count" : 1,
    "version_status" : "test",
    "modified_time_to_string" : "2025-05-13 17:11:25"
  }, {
    "status" : null,
    "region" : null,
    "domain_id" : null,
    "created_time" : null,
    "modified_time" : 1747126553000,
    "created_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "created_user_name" : "devcloud_devcloud_y00226182_05",
    "created_user_nick_name" : "仓库小能手",
    "created_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "modified_user_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_nick_name" : "仓库小能手",
    "modified_user_domain_name" : "devcloud_devcloud_y00226182_05",
    "id" : "a3770843d8594b0a9b3a1131a613689a",
    "project_id" : "f132b62084774001b84c294c0eef27f2",
    "file_id" : "3fe9d7a21bf04df2b0159ae958b6f9ad",
    "name" : "tool_version.json",
    "path" : "/",
    "size" : "0.0B",
    "version" : "latest",
    "version_count" : 1,
    "version_status" : "test",
    "modified_time_to_string" : "2025-05-13 16:55:53"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档