华为云用户手册

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result TemplateRepositoryList object 响应结果 status String 响应状态 表4 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表5 TemplateRepositoryList 参数 参数类型 描述 projects Array of TemplateRepository objects 模板列表 total Integer 模板总数 表6 TemplateRepository 参数 参数类型 描述 id Integer 模板唯一标识 name String 模板名称 template_name String 模板关联仓库名称 tags Array of strings 模板标签 description String 模板描述 brief_introduction String 模板简介 auto_pending_pipelines Integer 是否自动创建流水线 language String 模板语言分类 created_at String 模板创建时间 used_times Integer 模板引用次数 liked_times Integer 模板被点赞次数 creator_name String 模板创建人 https_url String 模板https链接

响应示例 状态码： 200 OK { "result" : { "projects" : [ { "id" : 453613, "name" : "javaMavenDemo", "template_name" : "javaMavenDemo", "tags" : [ "UnsupportedPipeline", "OTHERS", "鲲鹏 ARM64" ], "description" : "javaMavenDemo", "brief_introduction" : "javaMavenDemo", "auto_pending_pipelines" : 0, "language" : "OTHERS", "created_at" : "Sep 25, 2019 4:03:31 PM", "used_times" : 58, "liked_times" : 1, "creator_name" : "repo", "https_url" : "https://repo.alpha.devcloud.inhuawei.com/chentest00001/javaMavenDemo.git" } ], "total" : 100 }, "status" : "success"}

URI GET /v2/repositories/repository-templates 表1 Query参数 参数 是否必选 参数类型 描述 platform 否 String 模板平台类型 language 否 String 语言类型 pipeline 否 String 是否支持流水线 enter_type 否 String 模板分类 search 否 String 模板名称 date_order 否 String 模板日期排序 used_time_order 否 String 模板引用次数排序 type 否 String 模板公开类型 region 否 String 大区名称 page_no 是 Integer 分页页数 page_size 是 Integer 每页数据数

请求示例 PUT https://{endpoint}/v1/repositories/{repository_uuid}/template_status{"templateType": "SHARE", "codeTitle": "exampleTitle", "creatorName": "exampleName", "codeDescription": "exampleDescription", "languages": ['Java'], "plateform": ['Console'], "entertype": ['AI']}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 templateType 是 String 模板类型 codeTitle 否 String 代码模板名称 creatorName 否 String 创建者名称 codeDescription 否 String 代码模板描述 languages 否 Array of strings 模板语言 plateform 否 Array of strings 模板平台 entertype 否 Array of strings 模板类型

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result RepoCommitStatistics object 响应结果 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 RepoCommitStatistics 参数 参数类型 描述 all_branch_commits_count Integer 仓库总提交次数 codelines Array of RepoDailyCodeline objects 近15日每日代码提交行数 count Integer 对应分支仓库总提交次数 event RepoStatisticsEvent object 仓库统计状态 statistics Array of RepoStatistics objects 仓库统计列表 total Integer 仓库统计次数 表7 RepoDailyCodeline 参数 参数类型 描述 additions Integer 每日增加代码行 date String 日期 deletions Integer 每日删除代码行 表8 RepoStatisticsEvent 参数 参数类型 描述 branch String 分支名 最小长度：1 最大长度：260 created_at String 仓库统计创建的时间 date String 仓库统计的日期 id Integer 仓库统计事件的id project_id Integer 仓库id status String 仓库统计的状态: 等待统计waiting 正在统计active 完成统计finish updated_at String 仓库统计更新的时间 user_id Integer 用户id 表9 RepoStatistics 参数 参数类型 描述 add_lines Integer 添加代码行 branch String 分支名 最小长度：1 最大长度：260 commit_count Integer 提交次数 created_at String 仓库统计创建的时间 delete_lines Integer 删除代码行 id Integer 仓库统计记录id project_id Integer 仓库id updated_at String 仓库统计更新的时间 user_name String 用户名

响应示例 状态码： 200 OK { "result" : { "event" : null, "total" : 0, "statistics" : [ ], "all_branch_commits_count" : 1, "count" : 1, "codelines" : { "additions" : 0, "deletions" : 0, "date" : "20191015" } }, "status" : "success"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result FileContentInfo object 文件详情 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 FileContentInfo 参数 参数类型 描述 file_name String 文件名 file_path String 文件路径 size Integer 文件大小 encoding String 文件编码 content_sha256 String sha256编码的文件内容 ref String 分支名 blob_id String blob sha commit_id String 提交对应的SHA id last_commit_id String 最后一个提交对应的SHA id content String base64编码的文件内容

响应示例 状态码： 200 OK { "result" : { "size" : 9, "encoding" : "base64", "ref" : "master", "content" : "NDU0NTQ1NDQ1", "file_name" : "README.md", "file_path" : "README.md", "content_sha256" : "e16f4f6c41a79d120484774a625bea8a3c3dcb655aa7c7e793ac48639dc63944", "blob_id" : "3325fa3142fd66fedc8c3a5218b417f561e0ea2f", "commit_id" : "a772945ec2765e322cc83e0f467f394effa22cf3", "last_commit_id" : "a772945ec2765e322cc83e0f467f394effa22cf3" }, "status" : "success"}

响应示例 状态码： 200 OK { "result": [ { "id": "996f57b8fdd5e62678b16f0ea4f91688405fa72f", "individual_note": false, "notes": [ { "id": 2111974336, "type": "DiffNote", "body": "检视意见内容", "author": { "id": 9124, "name": "CodeHub_beta_dev", "username": "c369c68f1ff84679b5a8ed904d8bff1c", "state": "active", "avatar_url": "", "email": "liujian@example.com", "name_cn": "CodeHub_beta_dev", "web_url": "https://test.com/c369c68f1ff84679b5a8ed904d8bff1c", "nick_name": "我是昵称", "tenant_name": "devcloud_codehub_l00314597_01" }, "created_at": "2024-07-29T22:01:37.000+08:00", "updated_at": "2024-07-29T22:01:37.000+08:00", "system": false, "resolvable": true, "is_reply": false, "discussion_id": "996f57b8fdd5e62678b16f0ea4f91688405fa72f", "archived": false, "review_categories": "分类", "review_categories_cn": "分类", "review_categories_en": "分类", "review_modules": "模块", "severity": "suggestion", "severity_cn": "建议", "severity_en": "Suggestion", "assignee": { "id": 9124, "name": "CodeHub_beta_dev", "username": "c369c68f1ff84679b5a8ed904d8bff1c", "state": "active", "avatar_url": "", "email": "liujian@example.com", "name_cn": "CodeHub_beta_dev", "web_url": "https://test.com/c369c68f1ff84679b5a8ed904d8bff1c", "nick_name": "我是昵称", "tenant_name": "devcloud_codehub_l00314597_01" }, "proposer": { "id": 9124, "name": "CodeHub_beta_dev", "username": "c369c68f1ff84679b5a8ed904d8bff1c", "state": "active", "avatar_url": "", "email": "liujian@example.com", "name_cn": "CodeHub_beta_dev", "web_url": "https://test.com/c369c68f1ff84679b5a8ed904d8bff1c", "nick_name": "我是昵称", "tenant_name": "devcloud_codehub_l00314597_01" }, "position": { "base_sha": "a9ce1513d5185d5fe2bac52c597f204ce695c4be", "start_sha": "a9ce1513d5185d5fe2bac52c597f204ce695c4be", "head_sha": "53c75fa88dc4e7d0b68d108b7f1ee0a5c4564f44", "old_path": "a.txt", "new_path": "a.txt", "position_type": "text", "new_line": 1 }, "resolved": false } ], "project_id": 2111704470, "noteable_type": "MergeRequest", "project_full_path": "sll_test00006/mr_test", "a_mode": "0", "b_mode": "100644", "deleted_file": false, "new_file": true, "resolved": false, "archived": false, "review_categories": "分类", "review_categories_cn": "分类", "review_categories_en": "分类", "review_modules": "模块", "severity": "suggestion", "severity_cn": "建议", "severity_en": "Suggestion", "assignee": { "id": 9124, "name": "CodeHub_beta_dev", "username": "c369c68f1ff84679b5a8ed904d8bff1c", "state": "active", "avatar_url": "", "email": "liujian@example.com", "name_cn": "CodeHub_beta_dev", "web_url": "https://test.com/c369c68f1ff84679b5a8ed904d8bff1c", "nick_name": "我是昵称", "tenant_name": "devcloud_codehub_l00314597_01" }, "proposer": { "id": 9124, "name": "CodeHub_beta_dev", "username": "c369c68f1ff84679b5a8ed904d8bff1c", "state": "active", "avatar_url": "", "email": "liujian@example.com", "name_cn": "CodeHub_beta_dev", "web_url": "https://test.com/c369c68f1ff84679b5a8ed904d8bff1c", "nick_name": "我是昵称", "tenant_name": "devcloud_codehub_l00314597_01" }, "merge_request_version_params": {} } ], "status": "success"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误码 result Array of MergeRequestDiscussionDto object 参数解释： 返回新建检视意见的相关信息。 取值范围： 无。 status String 参数解释： 响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表4 Error 参数 参数类型 描述 code String 参数解释： 调用此接口失败时返回的错误码。 取值范围： CH.10000，系统繁忙，请稍后再试。 message String 参数解释： 调用此接口失败时返回的提示信息。 取值范围： “系统繁忙，请稍后再试”。 表5 MergeRequestDiscussionDto 参数 参数类型 描述 id String 参数解释： 主评论和回复共用的id，一般称为discussion_id。 取值范围： 只能为数字和字母，长度为40字符。 individual_note Boolean 参数解释： 是否为个人意见，即不需要他人解决的意见。 取值范围： true：不需要解决的意见 false：需要解决的意见 notes Array of NoteDto objects 参数解释： 主评论和回复列表，主评论为第一个（此接口为新建主评论，所以数量为1）。 取值范围： 无。 project_id Integer 参数解释： 仓库id 取值范围： 最小值：1 最大值：2147483647 noteable_type String 参数解释： 意见类型。 取值范围： MergeRequest：MR下提的意见(MR下点提交记录，选择一次提交加检视意见，仍是MergeRequest类型) Commit：代码下或一次提交下提的意见 commit_id String 参数解释： 关联的提交id：noteable_type为Commit的检视意见的特有字段，为此次提交的sha值。 取值范围： 只能为数字和字母，长度为40字符。 project_full_path String 参数解释： 仓库路径。 取值范围： 无。 a_mode String 参数解释： 关联文件变更前文件的文件模式，如果为新增文件此处为0。 取值范围： git支持的文件权限数字，例如：100644，100755，120000，160000等。 b_mode String 参数解释： 变更后文件的文件模式，如果为删除文件此处为0。 取值范围： git支持的文件权限数字，例如：100644，100755，120000，160000等。 deleted_file Boolean 参数解释： 关联文件是否是删除文件。 取值范围： true：关联文件是删除文件。 false或null：关联文件不是删除文件。 new_file Boolean 参数解释： 关联文件是否是新增文件。 取值范围： true：关联文件是新增文件。 false或null：关联文件不是新增文件。 resolved Boolean 参数解释： 检视意见是否已解决。 取值范围： true：检视意见已解决。 false或null：检视意见未解决。 archived Boolean 参数解释： 检视意见是否已归档，归档后不允许编辑删除回复解决该意见。 取值范围： true：检视意见已归档。 false或null：检视意见未归档。 review_categories String 参数解释： 检视意见分类的key。 自定义分类的review_categories、review_categories_cnreview_categories_en一致。 取值范围： 无。 review_categories_cn String 参数解释： 检视意见分类的中文名。 自定义分类的review_categories、review_categories_cn一致。 取值范围： 无。 review_categories_en String 参数解释： 检视意见分类的英文名。 自定义分类的review_categories、review_categories_en一致。 取值范围： 无。 review_modules String 参数解释： 检视意见模块。 取值范围： 无。 severity String 参数解释： 检视意见严重程度的key。 取值范围： suggestion：建议。 minor：一般。 major：严重。 fatal：致命。 severity_cn String 参数解释： 严重程度中文名。 取值范围： 建议 一般 严重 致命 severity_en String 参数解释： 严重程度英文名。 取值范围： Suggestion：建议 Minor：一般 Major：严重 Fatal：致命 assignee UserBasicDto object 参数解释： 指派人详细信息。 取值范围： 无。 proposer UserBasicDto object 参数解释： 检视人详细信息。 取值范围： 无。 merge_request_version_params MergeRequestVersionParamsDto object 参数解释： MR版本详细信息。 取值范围： 无。 diff_file String 参数解释： 变更文件路径。 取值范围： 无。 added_lines Integer 参数解释： 新增行数。 取值范围： 最小值：0 最大值：2147483647 removed_lines Integer 参数解释： 删除行数。 取值范围： 最小值：0 最大值：2147483647 表6 NoteDto 参数 参数类型 描述 id Integer 参数解释： 评论id，主评论和回复不共用。 取值范围： 最小值：1 最大值：2147483647 type String 参数解释： note类型。 取值范围： DiffNote：文件变更页提的需要解决的检视意见。 MergeRequestNote：详情页提的需要解决的检视意见。 null：详情页提的不需要解决的意见。 body String 参数解释： 检视意见内容。 取值范围： 长度限制：8000字符。 字符限制：unicode编码\u0000 - \uffff，不支持emoji表情、部分生僻字等特殊字符。 blank限制：不能为null或空字符串或全是空格。 attachment String 参数解释： 附件(废弃字段)。 取值范围： 无。 author UserBasicDto object 参数解释： 作者详细信息。 取值范围： 无。 created_at String 参数解释： 创建时间。 约束限制： 格式：yyyy-MM-ddTHH:mm:ss.SSS+08:00 updated_at String 参数解释： 更新时间。 约束限制： 格式：yyyy-MM-ddTHH:mm:ss.SSS+08:00 system Boolean 参数解释： 是否是系统生成的日志。 取值范围： true：系统创建的检视意见。 false：用户创建的检视意见。 noteable_id Integer 参数解释： MR的id。 取值范围： 最小值：1 最大值：2147483647 noteable_type String 参数解释： 意见类型。 取值范围： MergeRequest：MR或CR下提的意见(MR或CR下点提交记录，选择一次提交加检视意见，仍是MergeRequest类型) Commit：代码下或一次提交下提的意见 commit_id String 参数解释： 关联的提交id：noteable_type为Commit的检视意见的特有字段，为此次提交的sha值。 取值范围： 只能为数字和字母，长度为40字符。 resolvable Boolean 参数解释： 意见是否需要解决。 取值范围： true：可解决的检视意见。 false或null：不可解决的检视意见。 is_reply Boolean 参数解释： 是否是回复的评论。 取值范围： true：回复的评论。 false：主评论。 resolved_by UserBasicDto object 参数解释： 检视意见的解决人。 取值范围： 无。 noteable_iid Integer 参数解释： MR的iid，表示为该仓库第几个MR。 取值范围： 最小值：1 最大值：2147483647 discussion_id String 参数解释： 检视意见id，主评论和回复共用。 取值范围： 只能为数字和字母，长度为40字符。 project String 参数解释： 项目路径。 取值范围： 无。 diff_file String 参数解释： 变更文件路径。 取值范围： 无。 diff String 参数解释： 变更文件内容。 取值范围： 无。 archived Boolean 参数解释： 检视意见是否已归档，归档后不允许编辑删除回复解决该意见。 取值范围： true：检视意见已归档。 false或null：检视意见未归档。 review_categories String 参数解释： 检视意见分类的key。 自定义分类的review_categories、review_categories_cn、review_categories_en一致。 取值范围： 无。 review_categories_cn String 参数解释： 检视意见分类的中文名。 自定义分类的review_categories、review_categories_cn一致。 取值范围： 无。 review_categories_en String 参数解释： 检视意见分类的英文名。 自定义分类的review_categories、review_categories_en一致。 取值范围： 无。 review_modules String 参数解释： 检视意见模块。 取值范围： 无。 severity String 参数解释： 严重程度，非建议级别意见指派人和MR/Commit作者不能点解决。 取值范围： suggestion：建议； minor：一般； major: 严重； fatal：致命。 severity_cn String 参数解释： 严重程度中文名。 取值范围： 建议 一般 严重 致命 severity_en String 参数解释： 严重程度英文名。 取值范围： Suggestion：建议 Minor：一般 Major：严重 Fatal：致命 file_path String 参数解释： 文件路径(弃用)。 取值范围： 无。 line String 参数解释： 行号(弃用)。 取值范围： 无。 assignee UserBasicDto object 参数解释： 指派人详细信息。 取值范围： 无。 proposer UserBasicDto object 参数解释： 检视人详细信息。 取值范围： 无。 position PositionDto object 参数解释： 代码位置信息：意见关联何处代码 。 取值范围： 无。 resolved Boolean 参数解释： 检视意见是否已解决。 取值范围： true：检视意见已解决。 false或null：检视意见未解决。 is_outdated Boolean 参数解释： 是否过时。 取值范围： true：基于最新提交的检视意见。 false或null：不是基于最新提交的检视意见 表7 PositionDto 参数 参数类型 描述 base_sha String 参数解释： 源分支base提交节点。 取值范围： 只能为数字和字母，长度为40字符。 start_sha String 参数解释： 源分支最新提交节点。 取值范围： 只能为数字和字母，长度为40字符。 head_sha String 参数解释： 目标分支最新提交节点。 取值范围： 只能为数字和字母，长度为40字符。 old_path String 参数解释： 修改前文件路径。 取值范围： 无。 new_path String 参数解释： 修改后文件路径。 取值范围： 无。 position_type String 参数解释： 变更类型。 取值范围： 无。 默认取值： text。 old_line Integer 参数解释： 修改前行号，小于等于0或为null，表示此行为新增行，即对比时位于右侧，绿色显示。 取值范围： -1-2147483647或为null。 new_line Integer 参数解释： 修改后行号。 小于等于0或为null，表示此行为删除行，即对比时位于左侧，红色显示。 取值范围： -1-2147483647或为null。 表8 UserBasicDto 参数 参数类型 描述 id Integer 参数解释： 用户id。 取值范围： 最小值：1 最大值：2147483647 name String 参数解释： 名字。 取值范围： 长度为[0,255]个字符。 username String 参数解释： 用户名。 取值范围： 长度为[0,255]个字符。 state String 参数解释： 状态。 取值范围： 长度为[0,255]个字符。 avatar_url String 参数解释： 获取头像的url。 取值范围： 无。 avatar_path String 参数解释： 获取头像的路径。 取值范围： 无。 email String 参数解释： 邮箱。 取值范围： 无。 name_cn String 参数解释： 中文名。 约束限制： 此字段已弃用，取值同username。 取值范围： 无。 web_url String 参数解释： 主页url。 取值范围： 无。 nick_name String 参数解释： 昵称。 取值范围： 无。 tenant_name String 参数解释： 租户名称。 取值范围： 无。 表9 MergeRequestVersionParamsDto 参数 参数类型 描述 diff_id Integer 参数解释： MR每个版本提交都有其对应的diff_id(此处为MR最新提交)。 取值范围： 最小值：1 最大值：2147483647 start_sha String 参数解释： 目标分支最新提交节点。 取值范围： 只能为数字和字母，长度为40字符。 commit_id String 参数解释： 关联的提交id：noteable_type为Commit的检视意见的特有字段，为此次提交的sha值。 取值范围： 只能为数字和字母，长度为40字符。

URI GET /v2/repositories/{repository_id}/merge_requests/{merge_request_iid}/discussions 表1 路径参数 参数 是否必选 参数类型 描述 repository_id 是 String 参数解释： 仓库id。 约束限制： 必传。 取值范围： 最小值：1 最大值：214748364 merge_request_iid 是 Integer 参数解释： 合并请求iid(仓库的第几个mr)。 约束限制： 必传。 取值范围： 最小值：1 最大值：2147483647 表2 Query参数 参数 是否必选 参数类型 描述 type 否 String 参数解释： 检视意见类型。 取值范围： user：用户创建的检视意见。 system：系统创建的检视意见。 unresolved 否 String 参数解释： 检视意见是否未解决。 取值范围： true: 返回未解决的检视意见。 false: 返回已解决的检视意见。 view 否 String 参数解释： 返回基础信息或者详细信息。 取值范围： basic：返回基础信息。 simple：返回详细信息。 author_id 否 String 参数解释： 筛选所传用户创建的检视意见，可传用户id或用户名。 取值范围： 长度为[0,255]个字符。 page 否 Integer 参数解释： 分页参数，返回第几页的检视意见。 取值范围： 最小值：1 最大值：2147483647 默认值： 1 per_page 否 Integer 参数解释： 分页参数，每页的检视意见数量。 取值范围： 最小值：1 最大值：100 默认值： 20

响应示例 状态码： 200 OK { "result" : { "total" : 29, "repositories" : { "repository_uuid" : "0bf1e7ceb5b341318cb72b42901abe54", "repository_id" : 468564, "repository_name" : "test", "ssh_url" : "git@repo.alpha.devcloud.test.com:test_new00001/test.git", "https_url" : "https://repo.alpha.devcloud.test.com/test_new00001/test.git", "group_name" : "test_new00001", "web_url" : "https://alpha.devcloud.test.com/repo/468564/home", "visibility_level" : 0, "created_at" : "2019-10-15 11:00:11", "updated_at" : "2019-10-15 11:00:11", "repository_size" : "0.05M", "lfs_size" : "0.00M", "creator_name" : "repo", "domain_name" : "repo", "star" : true, "status" : 0, "is_owner" : 1, "iam_user_uuid" : "a618e34bd5704be3ae3395dfede06041", "project_uuid" : "dc19b3ca6f334ce894a1ec467689797d", "project_is_deleted" : "false", "userRole" : null } }, "status" : "success"}

URI GET /v2/projects/repositories 表1 Query参数 参数 是否必选 参数类型 描述 page_index 否 Integer 参数解释： 分页索引。 取值范围： 最小值：1 最大值：2147483647 默认取值： 1 page_size 否 Integer 参数解释： 每页条目数。 取值范围： 最小值：1 最大值：100 默认取值： 100 search 否 String 参数解释： 搜索关键字。 取值范围： 字符串长度不少于1，不超过512。 默认取值： 空。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 接口调用时，响应错误。 取值范围： 无。 result RepoListInfoV2 object 参数解释： 接口调用的响应结果。 取值范围： 无。 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表4 Error 参数 参数类型 描述 code String 参数解释： 调用此接口失败时返回的错误码。 取值范围： CH.080002 message String 参数解释： 调用此接口失败时返回的错误码。 取值范围： CH.080002 参数错误。 表5 RepoListInfoV2 参数 参数类型 描述 repositories Array of RepoInfoV2 objects 参数解释： 返回的仓库列表。 total Integer 参数解释： 返回的仓库总数。 取值范围： 0-2147483647 表6 RepoInfoV2 参数 参数类型 描述 created_at String 参数解释： 创建时间。 约束限制： 格式: yyyy-MM-dd HH:mm:ss creator_name String 参数解释： 创建者的用户名。 取值范围： 只能为数字和字母，长度为128字符。 domain_name String 参数解释： 创建者的租户名。 取值范围： 只能为数字和字母，长度为128字符。 group_name String 参数解释： 仓库代码组名。 (克隆地址中 域名 后面仓库名前的一段。 示例：git@repo.alpha.devcloud.test.com:Demo00228/testword.git 代码组名：Demo00228 ) 取值范围： 字符串长度不少于2，不超过255。 https_url String 参数解释： HTTPS仓库地址。 取值范围： 字符串长度不少于0，不超过2000。 iam_user_uuid String 参数解释： 用户IAM ID。 取值范围： 只能由数字和字母组成，且长度为32个字符。 is_owner Integer 参数解释： 是否是仓库的创建者。 取值范围： 1: 是创建者。 0: 不是创建者。 lfs_size String 参数解释： 仓库 LFS 容量。 约束限制： 单位M，或者G，保留2位小数。 project_is_deleted String 参数解释： 项目是否被删除。 取值范围： false: 项目没有删除。 true: 项目已经删除。 project_uuid String 参数解释： 项目ID，获取方式请参见获取项目ID。 取值范围： 只能由数字和字母组成，且长度为32个字符。 repository_id Integer 参数解释： 仓库ID。 取值范围： 只能由数字组成，且范围为0-2147483647。 repository_name String 参数解释： 仓库名。 取值范围： 字符串长度不少于2，不超过255。 repository_size String 参数解释： 仓库总容量 = 仓库LFS容量 + git库容量。 约束限制： 单位M，或者G，保留2为小数。 repository_uuid String 参数解释： 仓库UUID(由CreateRepository接口返回)。 约束限制： 只能由数字和字母组成，且长度为32个字符。 ssh_url String 参数解释： SSH仓库地址。 取值范围： 字符串长度不少于0，不超过2000。 star Boolean 参数解释： 当前用户是否收藏该仓库。 取值范围： false: 未收藏。 true: 已收藏。 status Integer 参数解释： 仓库状态。 取值范围： 0: 仓库正常创建成功。 1: 仓库创建中。 2: 创建失败。 3: 仓库冻结。 4: 仓库已经关闭。 updated_at String 参数解释： 更新时间。 约束限制： 格式: yyyy-MM-dd HH:mm:ss。 userRole Integer 参数解释： 用户在仓库中的角色。 约束限制： 20: 只读成员。 30: 普通成员 。 40: 管理员。 visibility_level Integer 参数解释： 仓库可见性。 取值范围： 0: 私有仓库。 20: 公有仓库。 web_url String 参数解释： web url 路径，访问它将跳转至仓库详情页。 取值范围： 字符串长度不少于0，不超过2000。

响应示例 状态码： 200 OK { "result" : { "total" : 1, "commits" : [ { "id" : "a27fafa7d8da2dd55f691bef989226d22f50d8ce", "message" : "Initial commit", "parent_ids" : [ ], "authored_date" : null, "author_name" : "repo", "author_email" : "repo@huawei.com", "committed_date" : "2019-10-15 09:40:29", "committer_name" : "repo", "committer_email" : "repo@huawei.com" } ] }, "status" : "success"}

URI GET /v1/repositories/{repository_id}/commits 表1 路径参数 参数 是否必选 参数类型 描述 repository_id 是 Integer 仓库主键id 表2 Query参数 参数 是否必选 参数类型 描述 author 否 String 提交作者 begin_date 否 String 起始提交日期，格式为yyyy-MM-dd end_date 否 String 终止提交日期，格式为yyyy-MM-dd message 否 String 提交信息 page_index 否 Integer 分页索引 缺省值：1 page_size 否 Integer 每页数据量 缺省值：10 path 否 String 文件路径 ref_name 是 String 分支或标签名，支持SHA格式 stat_format 否 String 提交的文件变更详情信息（不包含diff）

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result CommitList object 响应结果 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 CommitList 参数 参数类型 描述 commits Array of Commit objects 提交列表 total Integer 提交总数 表7 Commit 参数 参数类型 描述 author_email String 作者邮箱 author_name String 作者 authored_date String 作者提交时间 committed_date String 提交时间 committer_email String 提交作者邮箱 committer_name String 提交作者 format Object 文件变更的详情信息，其格式由请求查询参数 stat_format 决定 id String 提交对应的SHA id message String 提交的信息 parent_ids Array of strings 父提交id

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result BranchList object 响应结果 status String 响应状态 表4 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表5 BranchList 参数 参数类型 描述 branches Array of Branch objects 指定仓库的分支列表 total Integer 指定仓库的分支总数 表6 Branch 参数 参数类型 描述 is_protected Boolean 是否开启保护分支功能 name String 分支名

URI GET /v2/projects/{project_uuid}/repositories/template-status 表1 路径参数 参数 是否必选 参数类型 描述 project_uuid 是 String 项目ID，获取方式请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 page_no 否 Integer 分页页数 page_size 否 Integer 每页数据数

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result TemplateListInfo object 响应结果 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 TemplateListInfo 参数 参数类型 描述 repos Array of DevstarRepoInfo objects 仓库列表 total_count Integer 仓库总数 表7 DevstarRepoInfo 参数 参数类型 描述 uuid String 仓库的uuid repo_id String 仓库ID repo_name String 仓库名称 ssh_url String 仓库SSH地址 code_url String 仓库HTTPS地址 detail_url String 仓库预览地址

响应示例 状态码： 200 OK { "result" : { "repos" : [ { "uuid" : "36f532939c4b4e2191c10f5353ccf34c", "repo_id" : 487773, "repo_name" : "DDDDDDDD", "ssh_url" : "git@repo.alpha.devcloud.inhuawei.com:CHEN_TEST00001/DDDDDDDD.git", "code_url" : "https://repo.alpha.devcloud.inhuawei.com/CHEN_TEST00001/DDDDDDDD.git", "detail_url" : "https://alpha.devcloud.inhuawei.com/repo/487773/home" } ], "total_count" : 100 }, "status" : "success"}

响应示例 状态码： 200 OK { "result" : [ { "file_name" : "README.md", "file_path" : "README.md", "size" : 666, "encoding" : "base64", "ref" : "master", "blob_id" : "75c19b5b1904a72c8a9959c98ae6884d0ace0279", "file_type" : "text/plain; charset=utf-8", "content" : "RUVFRUVFRUU=" } ], "status" : "success"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result FilesResponseInfo object 响应结果 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 FilesResponseInfo 参数 参数类型 描述 file_name String 文件名称 file_path String 文件路径 size String 文件大小 encoding String 编码类型 ref String 分支名称 blob_id String 文件块id file_type String 文件类型 content String 文件内容

响应示例 状态码： 200 OK { "result" : { "total" : 2, "sshkey" : [ { "id" : "1015292", "title" : "reop1@test.com", "key" : "ssh-rsa AAAAB3NzaC1yc2EAAAADAQA*********************************************************Bqa/pE8buOrxri6AWqAky0bmtjSuVf reop1@test.com" }, { "id" : "1031709", "title" : "reop@test.com", "key" : "ssh-rsa AAAAB3NzaC1yc2EA*********************************************************U7xcma6HU8nj1E0i46VObWyOONl3gh142BV repo@test.com" } ] }, "status" : "success"}

响应参数 表2 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 接口调用时，响应错误。 取值范围： 无。 result PublicKeyList object 参数解释： 返回获取的SSH密钥列表。 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表3 PublicKeyList 参数 参数类型 描述 sshkey Array of PublicKey objects 参数解释： 返回的SSH密钥列表。 total Integer 参数解释： 返回的SSH密钥总数。 取值范围： 0-2147483647 表4 Error 参数 参数类型 描述 code String 参数解释： 调用此接口失败时返回的错误码。 取值范围： CH.10000，系统繁忙，请稍后再试。 message String 参数解释： 调用此接口失败时返回的提示信息。 取值范围： “系统繁忙，请稍后再试”。 表5 PublicKey 参数 参数类型 描述 id String 参数解释： 密钥ID。 取值范围： 只能由数字组成，且长度为[1-40]个字符。 key String 参数解释： 密钥，由用户上传。 取值范围： 只能数字组成，且长度为[0-2048]个字符。 title String 参数解释： 添加SSH密钥时输入的标题，由用户自定义输入。 取值范围： 长度为[0,255]个字符。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result RepoInfo object 响应结果 status String 响应状态 表4 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表5 RepoInfo 参数 参数类型 描述 createAt String 创建时间 groupName String 仓库组名(克隆地址中域名后面项目名前的一段 示例：git@codehub.alpha.devcloud.intest.com:Demo00228/testword.git 组名：Demo00228) httpUrl String https url id String 仓库uuid(由CreateRepository接口返回) 最小长度：32 最大长度：32 name String 仓库名 最小长度：2 最大长度：128 projectId String 项目的uuid 最小长度：32 最大长度：32 projectIsDelete String 项目是否被删除 repoId String 仓库主键id 最小长度：1 最大长度：40 sshUrl String ssh url visibilityLevel Integer 是否可见：0私有仓库，20公有仓库 webUrl String web url 访问路径

响应示例 状态码： 200 OK { "result" : { "id" : "dadb20863d7d4ef8bc0b4740db7358be", "repoId" : "472210", "name" : "testword", "sshUrl" : "git@codehub.alpha.devcloud.intest.com:Demo00228/testword.git", "httpUrl" : "https://codehub.alpha.devcloud.intest.com/Demo00228/testword.git", "groupName" : "Demo00228", "webUrl" : "https://alpha.devcloud.intest.com/codehub/472210/home", "visibilityLevel" : 0, "createAt" : "2019-10-21 17:49:33", "projectId" : "4838955a48e2492bbe44b31bc4c272f6", "projectIsDelete" : "false" }, "status" : "success"}

响应示例 状态码： 200 OK { "result" : { "name" : "master", "commit" : { "id" : "3b68902cf0eb7de3d5c8757e4a990bc3fe0af349", "short_id" : "3b68902c", "title" : "新建文件", "created_at" : "2022-03-08T03:14:39.000Z", "parent_ids" : [ "08618c900a4048aae7e4cd88913d3d521eae02eb" ], "message" : "新建文件", "author_name" : "repo", "committer_name" : "repo", "committed_date" : "2022-03-08T03:14:39.000Z" }, "protected" : true, "developers_can_push" : false, "developers_can_merge" : false, "master_can_push" : false, "master_can_merge" : false, "no_one_can_push" : true, "no_one_can_merge" : true, "in_an_opened_merge_request" : false }, "status" : "success"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误码 result AddProtectResponse object 参数解释： 响应结果 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表5 Error 参数 参数类型 描述 code String 参数解释： 错误码 取值范围： 符合错误码格式字符串，长度[0,100] message String 参数解释： 错误信息 取值范围： 不涉及 表6 AddProtectResponse 参数 参数类型 描述 name String 参数解释： 分支名称 commit CommitRepoV2 object 参数解释： 提交信息 protected Boolean 参数解释： 是否保护 developers_can_push Boolean 参数解释： 是否允许开发者提交 developers_can_merge Boolean 参数解释： 是否允许开发者合并 master_can_push Boolean 参数解释： 是否允许管理员提交 master_can_merge Boolean 参数解释： 是否允许管理员合并 no_one_can_push Boolean 参数解释： 没有人允许提交 no_one_can_merge Boolean 参数解释： 没有人允许合并 in_an_opened_merge_request Boolean 参数解释： 是否在一个打开的合并请求 表7 CommitRepoV2 参数 参数类型 描述 id String 参数解释： 提交对应的SHA id short_id String 参数解释： 提交对应的短SHA id created_at String 参数解释： 创建时间 title String 参数解释： 提交标题 parent_ids Array of strings 参数解释： 父提交id message String 参数解释： 提交信息 author_name String 参数解释： 作者 committer_name String 参数解释： 提交作者 committed_date String 参数解释： 提交时间