查询文件/项目列表
功能介绍
查询文件/项目列表
调用方法
请参见如何调用API。
URI
POST /devreposerver/v5/files/list
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
page_no |
否 |
Integer |
参数解释: 分页查询的页数。 约束限制: 不涉及。 取值范围: 最小值1,最大值2147483647。 默认取值: 1 |
page_size |
否 |
Integer |
参数解释: 分页查询的每页数据量。 约束限制: 不涉及。 取值范围: 最小值1,最大值100。 默认取值: 10 |
parent_id |
否 |
String |
参数解释: 父级目录id。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
project_id |
否 |
String |
参数解释: 项目id,对应"需求管理 CodeArts Req"项目唯一标识,私有依赖库首页地址栏url https://{host}/cloudartifact/project/{project_id}/repository中project_id变量的值。 约束限制: 不涉及。 取值范围: 只能使用小写英文字符及数字,字符串长度为32位。 默认取值: 不涉及。 |
search_name |
否 |
String |
参数解释: 搜索关键字。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
search_type |
否 |
String |
参数解释: 搜索类型。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
extension |
否 |
String |
参数解释: 后缀名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
order_by |
否 |
String |
参数解释: 排序字段。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
sort |
否 |
String |
参数解释: 排序方式。 约束限制: 不涉及。 取值范围: 升序或降序。 默认取值: 不涉及。 |
status |
否 |
String |
参数解释: 文件状态。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
category |
否 |
String |
参数解释: 发布包状态。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
参数解释: 请求成功、失败状态。 取值范围: success:请求成功。 error:请求失败。 |
trace_id |
String |
参数解释: 请求id,当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 |
result |
RepoFileDOV5Page object |
参数解释: 文件列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
total_records |
Integer |
参数解释: 总记录数。 取值范围: 不涉及。 |
total_pages |
Integer |
参数解释: 总页数。 取值范围: 不涉及。 |
data |
Array of RepoFileDOV5 objects |
参数解释: 文件列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释: id。 取值范围: 不涉及。 |
file_id |
String |
参数解释: 文件id。 取值范围: 不涉及。 |
repo_name |
String |
参数解释: 仓库id。 取值范围: 不涉及。 |
project_name |
String |
参数解释: 项目名称。 取值范围: 不涉及。 |
parent_id |
String |
参数解释: 父级目录ID。 取值范围: 不涉及。 |
name |
String |
参数解释: 文件名。 取值范围: 不涉及。 |
file_name |
String |
参数解释: 文件名。 取值范围: 不涉及。 |
type |
String |
参数解释: 文件类型, folder代表是目录,file代表文件。 取值范围: 不涉及。 |
category |
String |
参数解释: 发布包状态 test为测试包 prod为发布包。 取值范围: 不涉及。 |
extension |
String |
参数解释: 文件扩展名。 取值范围: 不涉及。 |
path |
String |
参数解释: 文件路径。 取值范围: 不涉及。 |
full_path |
String |
参数解释: 文件路径(含项目)。 取值范围: 不涉及。 |
size |
Long |
参数解释: 文件大小,单位为byte。 取值范围: 不涉及。 |
md5 |
String |
参数解释: md5。 取值范围: 不涉及。 |
sha256 |
String |
参数解释: sha256。 取值范围: 不涉及。 |
download_url |
String |
参数解释: 下载地址。 取值范围: 不涉及。 |
download_url_with_id |
String |
参数解释: 带有id的下载地址。 取值范围: 不涉及。 |
web_url |
String |
参数解释: web_url。 取值范围: 不涉及。 |
version_enable |
Boolean |
参数解释: version_enable。 取值范围: 不涉及。 |
migrated_state |
Integer |
参数解释: migrated_state。 取值范围: 不涉及。 |
upload_id |
String |
参数解释: upload_id。 取值范围: 不涉及。 |
请求示例
查询文件/项目列表
https://{URL}/devreposerver/v5/files/list
响应示例
状态码:200
OK
{ "status" : "success", "trace_id" : "0d7af913dfb4462db4580fc486d91ce1", "result" : { "data" : [ { "region" : "xx-xxxxx-x", "id" : "", "name" : "testjk1", "type" : "project", "created_time" : "2025-07-04 16:17:17", "modified_time" : "2025-07-04 16:17:17", "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", "project_id" : "8de56c5a10894ad3aaef9e6558f17ea3", "repo_name" : "xx-xxxxx-x_8de56c5a10894ad3aaef9e6558f17ea3_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/8de56c5a10894ad3aaef9e6558f17ea3/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_testjk1", "repo_file_path" : "nulltestjk1" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "Scrum-yc", "type" : "project", "created_time" : "2025-07-04 16:06:32", "modified_time" : "2025-07-04 16:06:32", "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", "project_id" : "4fad59a4d2be49039f2f18724a57dbff", "repo_name" : "xx-xxxxx-x_4fad59a4d2be49039f2f18724a57dbff_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/4fad59a4d2be49039f2f18724a57dbff/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_Scrum-yc", "repo_file_path" : "nullScrum-yc" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "wwy2", "type" : "project", "created_time" : "2025-06-27 16:05:41", "modified_time" : "2025-06-27 16:05:41", "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", "project_id" : "782ac1a952164acdb6d37924fae0828d", "repo_name" : "xx-xxxxx-x_782ac1a952164acdb6d37924fae0828d_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/782ac1a952164acdb6d37924fae0828d/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_wwy2", "repo_file_path" : "nullwwy2" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "330补丁版本", "type" : "project", "created_time" : "2025-06-16 15:28:35", "modified_time" : "2025-06-16 15:28:35", "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", "project_id" : "27edc4a6f5364d4bbe195ee5c046c581", "repo_name" : "xx-xxxxx-x_27edc4a6f5364d4bbe195ee5c046c581_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/27edc4a6f5364d4bbe195ee5c046c581/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_330补丁版本", "repo_file_path" : "null330%E8%A1%A5%E4%B8%81%E7%89%88%E6%9C%AC" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "版本测试", "type" : "project", "created_time" : "2025-04-14 11:04:16", "modified_time" : "2025-04-14 11:04:16", "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", "project_id" : "9202db82a84c4dac9313ea8df0f2a2d4", "repo_name" : "xx-xxxxx-x_9202db82a84c4dac9313ea8df0f2a2d4_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/9202db82a84c4dac9313ea8df0f2a2d4/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_版本测试", "repo_file_path" : "null%E7%89%88%E6%9C%AC%E6%B5%8B%E8%AF%95" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "landingzone test", "type" : "project", "created_time" : "2024-11-12 15:54:57", "modified_time" : "2024-11-12 15:54:57", "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", "project_id" : "74698d06d75f41b782f834c802c9bae7", "repo_name" : "xx-xxxxx-x_74698d06d75f41b782f834c802c9bae7_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/74698d06d75f41b782f834c802c9bae7/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_landingzone test", "repo_file_path" : "nulllandingzone%20test" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "CodeArtsArtifact_Apig_Sonar", "type" : "project", "created_time" : "2024-10-24 20:53:51", "modified_time" : "2024-10-24 20:53:51", "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", "project_id" : "bc634ac7a3894a1d91ca72aad5e72bdf", "repo_name" : "xx-xxxxx-x_bc634ac7a3894a1d91ca72aad5e72bdf_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/bc634ac7a3894a1d91ca72aad5e72bdf/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_CodeArtsArtifact_Apig_Sonar", "repo_file_path" : "nullCodeArtsArtifact_Apig_Sonar" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "donglingshi", "type" : "project", "created_time" : "2024-10-15 17:30:46", "modified_time" : "2024-10-15 17:30:46", "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", "project_id" : "eb2429dc4f3349e5b47163a9bfd1210b", "repo_name" : "xx-xxxxx-x_eb2429dc4f3349e5b47163a9bfd1210b_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/eb2429dc4f3349e5b47163a9bfd1210b/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_donglingshi", "repo_file_path" : "nulldonglingshi" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "test0416-001", "type" : "project", "created_time" : "2024-04-16 16:25:41", "modified_time" : "2024-04-16 16:25:41", "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", "project_id" : "bef3419620d743eca6a57881a0f006fd", "repo_name" : "xx-xxxxx-x_bef3419620d743eca6a57881a0f006fd_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/bef3419620d743eca6a57881a0f006fd/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_test0416-001", "repo_file_path" : "nulltest0416-001" }, { "region" : "xx-xxxxx-x", "id" : "", "name" : "功能自动化专用项目(勿动勿删)", "type" : "project", "created_time" : "2024-03-26 14:41:57", "modified_time" : "2024-03-29 15:58:06", "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", "project_id" : "99b6617f8e0a4b67a856738d6355b2f0", "repo_name" : "xx-xxxxx-x_99b6617f8e0a4b67a856738d6355b2f0_generic_0", "parent_id" : "0", "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=null&type=archive", "web_url" : "releaseman/project/99b6617f8e0a4b67a856738d6355b2f0/private/general?parentId=0", "version_enable" : false, "migrated_state" : 0, "repo_same_trash_file_name" : "trash_null_功能自动化专用项目(勿动勿删)", "repo_file_path" : "null%E5%8A%9F%E8%83%BD%E8%87%AA%E5%8A%A8%E5%8C%96%E4%B8%93%E7%94%A8%E9%A1%B9%E7%9B%AE(%E5%8B%BF%E5%8A%A8%E5%8B%BF%E5%88%A0)" } ], "total_records" : 151, "total_pages" : 16 } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。