更新时间:2025-07-30 GMT+08:00
分享

查询文件/项目列表

功能介绍

查询文件/项目列表

调用方法

请参见如何调用API

URI

POST /devreposerver/v5/files/list

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

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

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释:

请求成功、失败状态。

取值范围:

success:请求成功。

error:请求失败。

trace_id

String

参数解释:

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

取值范围:

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

result

RepoFileDOV5Page object

参数解释:

文件列表。

取值范围:

不涉及。

表3 RepoFileDOV5Page

参数

参数类型

描述

total_records

Integer

参数解释:

总记录数。

取值范围:

不涉及。

total_pages

Integer

参数解释:

总页数。

取值范围:

不涉及。

data

Array of RepoFileDOV5 objects

参数解释:

文件列表。

取值范围:

不涉及。

表4 RepoFileDOV5

参数

参数类型

描述

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

错误码

请参见错误码

相关文档