华为云用户手册

请求示例 通过checksum搜索文件 https://artifact.cn-south-1.myhuaweicloud.com/cloudartifact/v5/search/checksum?checksum=eb05a9df1e3403a5f54e03de073a6ce6&page_no=1&page_size=10&in_project=true&project_id=e2ee90487d6349dd944a5767225f6f55&format=pypi

URI GET /cloudartifact/v5/search/checksum 表1 Query参数 参数 是否必选 参数类型 描述 checksum 是 String 参数解释: 文件校验和，可在页面文件详细信息概览中获取，文件校验和的MD5, SHA-1, SHA-256, SHA-512任意值。 约束限制: 不涉及。 取值范围: 只能使用英文字符、数字，字符串长度32、40、64、128。 默认取值: 不涉及。 page_no 否 Integer 参数解释: 页码。 约束限制: 不涉及。 取值范围: 最小值1。 默认取值: 1 page_size 否 Integer 参数解释: 每页大小。 约束限制: 不涉及。 取值范围: 最小值1，最大值100。 默认取值: 10 format 否 String 参数解释: 仓库类型。 约束限制: 不涉及。 取值范围: 允许的类型为: maven2|npm|go|pypi|rpm|composer|debian|conan|nuget|docker2|cocoapods|ohpm。 默认取值: 不涉及。 in_project 否 String 参数解释: 是否在项目中，值为true，project_id有值时，查询指定项目数据；project_id无值时，查询当前账号所有项目数据。值为false或不传值时查询当前租户下未关联项目的仓库数据。 约束限制: 不涉及。 取值范围: true or false。 默认取值: 不涉及。 project_id 否 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，私有依赖库首页地址栏url https://{host}/cloudartifact/project/{project_id}/repository中project_id变量的值。 约束限制: 参数in_project值为true值时此参数生效。 取值范围: 只能使用小写英文字符及数字，字符串长度为32位。 默认取值: 不涉及。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Array of objects 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143006-1701220804200-277", "result" : [ { "name" : "mod.txt", "relativePath" : "1/1/mod.txt", "createdBy" : null, "createdUserName" : "devcloud_devcloud_y00226182_01", "created" : null, "modified" : "2023-11-29T09:19:13.711+08:00", "repo" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_pypi_40", "repoName" : "testpypi", "displayName" : null, "oldRepoId" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_pypi_40", "repoType" : "pypi" } ] }

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143002-1701221035715-403", "result" : { "artifacts" : [ { "name" : "mod.txt", "relativePath" : "1/1/mod.txt", "createdBy" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_e9253deb37654775bb3c411aca89153a", "createdUserName" : "devcloud_devcloud_y00226182_01", "created" : "1701220753711", "modified" : "2023-11-29T09:19:13.711+08:00", "repo" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_pypi_40", "repoName" : "testpypi", "displayName" : null, "oldRepoId" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_pypi_40", "repoType" : "pypi" } ] } }

请求示例 统筹搜索 https://artifact.cn-south-1.myhuaweicloud.com/cloudartifact/v5/tree/repos/artifacts { "artifact_name" : "mod.txt", "artifact_type" : "pypi", "page_no" : 1, "page_size" : 10, "project_id" : "e2ee90487d6349dd944a5767225f6f55", "in_project" : true }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Array of objects 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143002-1701176094147-90", "result" : [ { "status" : "active", "domainId" : "5a775fdcb14f4431b6c0015618140bc3", "region" : "cn-north-7", "createdTime" : "2023-11-24 17:13:52", "modifiedTime" : "2023-11-24 17:13:52", "createdUserId" : "e9253deb37654775bb3c411aca89153a", "createdUserName" : "devcloud_devcloud_y00226182_01", "modifiedUserId" : null, "modifiedUserName" : null, "name" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_5_120", "disable" : false, "format" : "maven2", "type" : "virtual", "policy" : "release", "tabId" : "5a775fdcb14f4431b6c0015618140bc3_tab_maven2_120", "repositoryName" : "adasasfsafdasdfasd", "displayName" : "adasasfsafdasdfasd", "description" : "", "snapshot" : null, "release" : null, "npm" : null, "snapshotStatus" : null, "releaseStatus" : null, "projectId" : "e2ee90487d6349dd944a5767225f6f55", "includesPattern" : "**/*", "repositoryIds" : null, "uri" : null, "deploymentPolicy" : null, "repositories" : null, "parentRepoName" : null, "userName" : null, "password" : "***", "remoteUrl" : null, "defaultDeployRepository" : null, "remoteType" : null, "proxy" : null, "allowAnonymous" : null, "autoCleanSnapshot" : null, "snapshotAliveDays" : null, "maxUniqueSnapshots" : null, "shareRight" : "PROJECT", "nexuRepo" : false, "username" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_e9253deb37654775bb3c411aca89153a", "url" : "https://devrepo.devcloud.cn-north-7.ulanqab.huawei.com/artgalaxy/cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_5_120/", "packageType" : "maven" } ] }

URI GET /devreposerver/v2/release/{project_id}/files 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 项目ID，对应"需求管理 CodeArts Req"项目唯一标识，私有依赖库首页地址栏url https://{host}/cloudartifact/project/{project_id}/repository中project_id变量的值。 约束限制: 不涉及。 取值范围: 只能使用小写英文字符及数字，字符串长度为1-32位。 默认取值: 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 file_name 是 String 参数解释: 用于模糊搜索的文件名称。 约束限制: 不涉及。 取值范围: 只能使用中英文字符，数字，下划线(_)，连字符(-)和点(.)，字符串长度为1-200。 默认取值: 不涉及。 limit 否 Integer 参数解释: 每页显示的条目数量。 约束限制: 不涉及。 取值范围: 1-100。 默认取值: 10 offset 否 Integer 参数解释: 此次分页查询数据开始的位置。 约束限制: 不涉及。 取值范围: 大于0。 默认取值: 0

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result result object 参数解释: 返回的具体结果信息 取值范围: 不涉及。 默认取值: 无。 表5 result 参数 参数类型 描述 data Array of ReleaseFileVersionDo objects 参数解释: 符合条件的结果列表 取值范围: 不涉及。 默认取值: 无。 total_records Integer 参数解释: 符合条件的结果总条数。 取值范围: 1-1000。 默认取值: 无。 total_pages Integer 参数解释: 符合条件的结果总页数。 取值范围: 1-10000。 默认取值: 无。 表6 ReleaseFileVersionDo 参数 参数类型 描述 version String 参数解释: 发布库文件的版本 取值范围: 0-100长度的字符串。 默认取值: 无。 path String 参数解释: 发布库文件的路径 取值范围: 0-100长度的字符串。 默认取值: 无。 download_url String 参数解释: 发布库文件的下载链接 取值范围: 0-10000长度的字符串。 默认取值: 无。 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 错误码。 取值范围: 200-599。 默认取值: 无。 error_msg String 参数解释: 错误信息。 取值范围: 不涉及。 默认取值: 无。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 参数解释: 错误码。 取值范围: 200-599。 默认取值: 无。 error_msg String 参数解释: 错误信息。 取值范围: 不涉及。 默认取值: 无。

URI GET /cloudartifact/v5/storage 表1 Query参数 参数 是否必选 参数类型 描述 format_list 否 String 参数解释： 仓库类型列表。 约束限制： 不涉及。 取值范围： maven2，docker，conan，debian，go，nuget，rpm，pypi，npm，cocoapods，generic。 默认取值： 不涉及。 in_project 否 String 参数解释： 是否在项目中。 约束限制： 不涉及。 取值范围： true：项目中。 false：项目外。 默认取值： 不涉及。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

URI GET /cloudartifact/v5/attention/artifacts 表1 Query参数 参数 是否必选 参数类型 描述 page_no 否 Integer 参数解释: 页码。 约束限制: 不涉及。 取值范围: 最小值1。 默认取值: 1 page_size 否 Integer 参数解释: 每页大小。 约束限制: 不涉及。 取值范围: 最小值1，最大值100。 默认取值: 10 project_id 否 String 参数解释: 项目id，对应"需求管理 CodeArts Req"项目唯一标识，私有依赖库首页地址栏url https://{host}/cloudartifact/project/{project_id}/repository中project_id变量的值。 约束限制: 不涉及。 取值范围: 只能使用小写英文字符及数字，字符串长度为32位。 默认取值: 不涉及。

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143006-1701222864960-289", "result" : { "data" : [ { "id" : "43e78ea4903d468db517e069ab91ce1c", "domainId" : "5a775fdcb14f4431b6c0015618140bc3", "repositoryId" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_1_108", "repositoryName" : "maven1", "format" : "maven2", "policy" : "release", "artifactId" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_1_108/1/1/1/1-1-1.jar", "path" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_1_108/1/1/1/1-1-1.jar", "modifiedUserName" : "devcloud_devcloud_y00226182_01", "modifiedUserId" : "e9253deb37654775bb3c411aca89153a", "userId" : null, "modifiedTime" : "2023-11-29 09:54:22", "region" : "cn-north-7" } ], "totalRecords" : 1, "totalPages" : 1 } }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

URI GET /cloudartifact/v5/{tenant_id}/{project_id}/storageinfo/statistic 表1 路径参数 参数 是否必选 参数类型 描述 tenant_id 是 String 租户id project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 repo 否 String 仓库id start_time 否 String 起始时间 end_time 否 String 终止时间 instance_id 否 String 实例id

请求示例 查询存储容量趋势 https://artifact.cn-south-1.myhuaweicloud.com/cloudartifact/v5/00000000000000000000000000000000/00000000000000000000000000000000/storageinfo/statistic?start_time=2023-11-22&end_time=2023-11-28&repo=cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_1_108

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Array of objects 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143006-1701222420819-287", "result" : [ { "filesCount" : 2, "usedSpaceLength" : 1034390, "usedSpace" : "1,010.15 KB", "summaryDate" : "2023-11-22", "foldersCount" : null, "itemsCount" : null }, { "filesCount" : 2, "usedSpaceLength" : 1034390, "usedSpace" : "1,010.15 KB", "summaryDate" : "2023-11-23", "foldersCount" : null, "itemsCount" : null }, { "filesCount" : 2, "usedSpaceLength" : 1034390, "usedSpace" : "1,010.15 KB", "summaryDate" : "2023-11-24", "foldersCount" : null, "itemsCount" : null }, { "filesCount" : 2, "usedSpaceLength" : 1034390, "usedSpace" : "1,010.15 KB", "summaryDate" : "2023-11-25", "foldersCount" : null, "itemsCount" : null }, { "filesCount" : 2, "usedSpaceLength" : 1034390, "usedSpace" : "1,010.15 KB", "summaryDate" : "2023-11-26", "foldersCount" : null, "itemsCount" : null }, { "filesCount" : 4, "usedSpaceLength" : 2068780, "usedSpace" : "1.97 MB", "summaryDate" : "2023-11-27", "foldersCount" : null, "itemsCount" : null }, { "filesCount" : 0, "usedSpaceLength" : 0, "usedSpace" : "", "summaryDate" : "2023-11-28", "foldersCount" : null, "itemsCount" : null } ] }

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143003-1701176455154-4616", "result" : { "artifactory" : { "status" : null, "domainId" : "5a775fdcb14f4431b6c0015618140bc3", "region" : "cn-north-7", "createdTime" : null, "modifiedTime" : null, "createdUserId" : "e9253deb37654775bb3c411aca89153a", "createdUserName" : "devcloud_devcloud_y00226182_01", "modifiedUserId" : "e9253deb37654775bb3c411aca89153a", "modifiedUserName" : "devcloud_devcloud_y00226182_01", "name" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_pypi_41", "disable" : false, "format" : "pypi", "type" : "hosted", "policy" : null, "tabId" : null, "repositoryName" : "test-pypi", "displayName" : null, "description" : "", "snapshot" : null, "release" : null, "npm" : null, "snapshotStatus" : null, "releaseStatus" : null, "projectId" : "e2ee90487d6349dd944a5767225f6f55", "includesPattern" : "**/*", "repositoryIds" : null, "uri" : null, "deploymentPolicy" : null, "repositories" : null, "parentRepoName" : null, "userName" : null, "password" : null, "remoteUrl" : null, "defaultDeployRepository" : null, "remoteType" : null, "proxy" : null, "allowAnonymous" : null, "autoCleanSnapshot" : null, "snapshotAliveDays" : null, "maxUniqueSnapshots" : null, "shareRight" : "PROJECT", "nexuRepo" : false, "url" : "https://devrepo.devcloud.cn-north-7.ulanqab.huawei.com/artgalaxy/api/pypi/cn-north-7_5a775fdcb14f4431b6c0015618140bc3_pypi_41/", "packageType" : "pypi" } } }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 format 是 String 仓库格式 type 是 String 仓库类型 repository_name 是 String 仓库名称 description 否 String 仓库描述 includes_pattern 是 String 路径白名单 project_id 否 String 项目id share_right 否 String 共享策略

请求示例 创建非maven仓库 https://artifact.cn-south-1.myhuaweicloud.com/cloudartifact/v5/artifact/ { "repository_name" : "test-pypi", "type" : "hosted", "format" : "pypi", "description" : "", "includes_pattern" : "**/*", "share_right" : "PROJECT", "project_id" : "e2ee90487d6349dd944a5767225f6f55" }

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of TrashArtifactModelForDelete objects 批量删除列表 表2 TrashArtifactModelForDelete 参数 是否必选 参数类型 描述 id 是 String 仓库id fomat 是 String 仓库类型 uri 是 String URI status 是 String 状态 include_pattern 否 String 路径白名单

请求示例 批量删除回收站 https://artifact.cn-south-1.myhuaweicloud.com/cloudartifact/v5/trashes [ { "id" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_debian_43", "format" : "debian", "uri" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_debian_43/", "status" : "active" }, { "id" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_go_4", "format" : "go", "uri" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_go_4/", "status" : "active" } ]

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

响应示例 状态码： 200 OK { "status" : "success", "trace_id" : "143002-1701175561381-82", "result" : { "status" : null, "domainId" : null, "region" : null, "createdTime" : null, "modifiedTime" : null, "createdUserId" : null, "createdUserName" : null, "modifiedUserId" : null, "modifiedUserName" : null, "name" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_1_201", "disable" : false, "format" : "maven2", "type" : "hosted", "policy" : null, "tabId" : "5a775fdcb14f4431b6c0015618140bc3_tab_maven2_201", "repositoryName" : "testmaven", "displayName" : null, "description" : "12", "snapshot" : "testmaven", "release" : "testmaven", "npm" : null, "snapshotStatus" : "active", "releaseStatus" : "active", "projectId" : "e2ee90487d6349dd944a5767225f6f55", "includesPattern" : "**/*", "repositoryIds" : null, "uri" : null, "deploymentPolicy" : "allowRedeploy", "repositories" : null, "parentRepoName" : null, "userName" : null, "password" : null, "remoteUrl" : null, "defaultDeployRepository" : null, "remoteType" : null, "proxy" : null, "allowAnonymous" : false, "autoCleanSnapshot" : null, "snapshotAliveDays" : null, "maxUniqueSnapshots" : "10", "shareRight" : "PROJECT", "nexuRepo" : false, "url" : "https://devrepo.devcloud.cn-north-7.ulanqab.huawei.com/artgalaxy/cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_1_201/", "packageType" : "maven" } }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error：请求失败。 trace_id String 参数解释: 请求id，当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果，接口不同，返回不同。 取值范围: 根据不同接口有不同范围。

URI GET /cloudartifact/v5/{tenant_id}/{project_id}/{repo_id}/repositories 表1 路径参数 参数 是否必选 参数类型 描述 tenant_id 是 String 租户id project_id 是 String 项目id repo_id 是 String 仓库id 表2 Query参数 参数 是否必选 参数类型 描述 region 是 String 服务区