华为云用户手册

使用BGP路由模式时，华为云AS号是多少？ 华为云BGP AS号取值范围为1-4294967295，一般情况下，华为云侧的BGP AS号默认是64512。 详细情况请参见表1。 表1 华为云不同区域对应的BGP AS号默认值 区域 默认值 除了华北-北京一区域以及亚太-曼谷区域的部分接入点 64512 华北-北京一 65533 亚太-曼谷 部分接入点的AS号默认是65535，具体请联系专线经理确认。 父主题： Console及页面使用

URI GET /v1/repositories/repoid 表1 Query参数 参数 是否必选 参数类型 描述 group_name 是 String 仓库组名(克隆地址中 域名 后面仓库名前的一段 示例：git@repo.alpha.devcloud.inhuawei.com:Demo00228/testword.git 组名：Demo00228 ) repository_name 是 String 仓库名

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result Array of CommitStatistic objects 代码增加和删除的行数 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 CommitStatistic 参数 参数类型 描述 additions Integer 增加的行数 deletions Integer 删除的行数

URI GET /v2/repositories/{repository_id}/commit_lines 表1 路径参数 参数 是否必选 参数类型 描述 repository_id 是 Integer 仓库短id 表2 Query参数 参数 是否必选 参数类型 描述 ref_name 是 String 分支名称 begin_date 是 String 起始提交日期,格式为yyyy-MM-dd end_date 是 String 终止提交日期,格式为yyyy-MM-dd（begin_date和end_date时间间隔不超过60天）

响应示例 状态码： 200 OK { "result" : { "repository_uuid" : "045ceabb9aea40579d5a759e84fa7f0a", "repository_id" : 468485, "repository_name" : "CreatRepository_MI9Af", "ssh_url" : "git@repo.alpha.devcloud.inhuawei.com:Demo00228/CreatRepository_MI9Af.git", "https_url" : "https://repo.alpha.devcloud.inhuawei.com/Demo00228/CreatRepository_MI9Af.git", "group_name" : "Demo00228", "web_url" : "https://alpha.devcloud.inhuawei.com/repo/468485/home", "visibility_level" : 0, "created_at" : "2019-10-15 09:40:27", "updated_at" : null, "repository_size" : null, "lfs_size" : null, "creator_name" : null, "domain_name" : null, "star" : null, "status" : null, "is_owner" : null, "iam_user_uuid" : null, "project_uuid" : "4838955a48e2492bbe44b31bc4c272f6", "project_is_deleted" : "false", "userRole" : null }, "status" : "success"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误: result RepoInfoV2 object 参数解释： 响应结果 status String 参数解释： 响应状态 取值范围: success fail 表4 Error 参数 参数类型 描述 code String 参数解释： 错误码 取值范围: 请参见错误码 message String 参数解释： 错误信息 取值范围: 字符串 表5 RepoInfoV2 参数 参数类型 描述 created_at String 参数解释： 创建时间 取值范围: 字符串 creator_name String 参数解释： 创建者的用户名，在用户是租户的情况下，用户名和租户名相等 取值范围: 字符串 domain_name String 参数解释： 创建者的租户名 取值范围: 字符串 group_name String 参数解释： 仓库组名(克隆地址中域名后面仓库名前的一段 示例：git@repo.alpha.devcloud.inhuawei.com:Demo00228/testword.git 组名：Demo00228 ) 取值范围: 字符串 https_url String 参数解释： 使用 https 克隆仓库时所使用的 url 取值范围: 字符串 iam_user_uuid String 参数解释： 用户的 iam user uuid 取值范围: 字符串 is_owner Integer 参数解释： 当前用户是否是仓库的创建者 取值范围: 1：是 0：不是 lfs_size String 参数解释： 仓库 LFS 容量，单位为M，大于 1024M 则单位为 G 取值范围: 字符串 project_is_deleted String 参数解释： 项目是否被删除 取值范围: 字符串 project_uuid String 参数解释： 项目ID，获取方式请参见获取项目ID 取值范围: 字符串 repository_id Integer 参数解释： 仓库主键id 取值范围: 1-2,147,483,647 repository_name String 参数解释： 仓库名 取值范围: 字符串 repository_size String 参数解释： 仓库总容量 = 仓库 LFS 容量 + git 库容量，单位为M，大于 1024M 则单位为 G 取值范围: 字符串 repository_uuid String 参数解释： 仓库uuid(由CreateRepository接口返回) 取值范围: 字符串 ssh_url String 参数解释： 使用 ssh 方式克隆仓库时所使用的 url 取值范围: 字符串 star Boolean 参数解释： 当前用户是否收藏该仓库 取值范围: true：已收藏 false：未收藏 status Integer 参数解释： 仓库状态 取值范围: 0：仓库正常创建成功 1：仓库创建中 2：创建失败 3：仓库冻结 4：仓库已经关闭 updated_at String 参数解释： 更新时间 取值范围: 字符串 userRole Integer 参数解释： 用户在仓库中的权限 取值范围: 20：只读成员 30：普通成员 40：管理员 visibility_level Integer 参数解释： 可见范围 取值范围: 0，私有仓库 20，公有仓库 web_url String 参数解释： web url 路径，访问它将跳转至仓库详情页 取值范围: 字符串

响应示例 状态码： 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/{group_name}/{repository_name}/commits 表1 路径参数 参数 是否必选 参数类型 描述 group_name 是 String 仓库组名(克隆地址中域名后面仓库名前的一段 示例：git@repo.alpha.devcloud.inhuawei.com:Demo00228/testword.git 组名：Demo00228 ) repository_name 是 String 仓库名 表2 Query参数 参数 是否必选 参数类型 描述 page_index 否 Integer 分页索引 page_size 否 Integer 每页数据量 ref_name 是 String 分支或标签名，支持SHA格式

响应参数 状态码： 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 OK { "result" : { "total" : 14, "repositories" : { "repository_uuid" : "d0457f74cc5b43d989ded7248f71b4e5", "repository_id" : 468480, "repository_name" : "CreatRepository_2qD5i", "ssh_url" : "git@repo.test.com:Demo00228/CreatRepository_2qD5i.git", "https_url" : "https://test.com/Demo00228/CreatRepository_2qD5i.git", "group_name" : "Demo00228", "web_url" : "https://test.com/repo/468480/home", "visibility_level" : 0, "created_at" : "2019-10-15 09:40:26", "updated_at" : "2019-10-15 09:40:26", "repository_size" : "0.06M", "lfs_size" : "0.00M", "creator_name" : "repo", "domain_name" : "repo", "star" : false, "status" : 0, "is_owner" : 1, "iam_user_uuid" : "a618e34bd5704be3ae3395dfede06041", "project_uuid" : "4838955a48e2492bbe44b31bc4c272f6", "project_is_deleted" : "false", "userRole" : null } }, "status" : "success"}

URI GET /v2/projects/{project_uuid}/repositories 表1 路径参数 参数 是否必选 参数类型 描述 project_uuid 是 String 参数解释： 项目ID，获取方式请参见获取项目ID。 约束限制： 必传。 取值范围: 32位字符串。 默认取值: 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 page_index 否 Integer 参数解释： 分页索引，从1开始计数。 约束限制： 不涉及。 取值范围: 1-2,147,483,647 默认取值: 1 page_size 否 Integer 参数解释： 每页条目数。 约束限制： 不涉及。 取值范围: 1-100 默认取值: 20 search 否 String 参数解释： 搜索关键字。 约束限制： 不涉及。 取值范围: 字符串。 默认取值: 不涉及。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误: result RepoListInfoV2 object 参数解释： 响应结果 status String 参数解释： 响应状态 取值范围: success，表示接口调用成功。 fail，表示接口调用失败。 表5 Error 参数 参数类型 描述 code String 参数解释： 错误码。 取值范围: 请参见错误码。 message String 参数解释： 错误信息。 取值范围: 字符串。 表6 RepoListInfoV2 参数 参数类型 描述 repositories Array of RepoInfoV2 objects 参数解释： 仓库列表。 total Integer 参数解释： 仓库总数。 取值范围: 1-2147483647 表7 RepoInfoV2 参数 参数类型 描述 created_at String 参数解释： 创建时间。 取值范围: 字符串。 creator_name String 参数解释： 创建者的用户名，当用户是租户，用户名和租户名一样。 取值范围: 字符串。 domain_name String 参数解释： 创建者的租户名。 取值范围: 字符串。 group_name String 参数解释： 仓库组名(克隆地址中域名后面仓库名前的一段。 示例：git@repo.alpha.devcloud.test.com:Demo00228/testword.git 组名：Demo00228 )。 取值范围: 字符串。 https_url String 参数解释： 使用HTTPS克隆仓库时所使用的URL。 取值范围: 字符串。 iam_user_uuid String 参数解释： 用户的 IAM User UUID。 取值范围: 字符串。 is_owner Integer 参数解释： 当前用户是否是仓库的创建者。 取值范围: 1：是 0：不是 lfs_size String 参数解释： 仓库LFS容量，单位为M，当容量大于1024M，单位为G。 取值范围: 字符串。 project_is_deleted String 参数解释： 项目是否被删除。 取值范围: 字符串。 project_uuid String 参数解释： 项目ID，获取方式请参见获取项目ID。 取值范围: 字符串。 repository_id Integer 参数解释： 仓库主键ID。 取值范围: 1-2147483647 repository_name String 参数解释： 仓库名称。 取值范围: 字符串。 repository_size String 参数解释： 仓库总容量=仓库LFS容量 +Git库容量，单位为M，当容量大于1024M，单位为G。 取值范围: 字符串。 repository_uuid String 参数解释： 仓库UUID(由CreateRepository接口返回)。 取值范围: 字符串。 ssh_url String 参数解释： 使用SSH方式克隆仓库时所使用的URL。 取值范围: 字符串。 star Boolean 参数解释： 当前用户是否收藏该仓库。 取值范围: true：已收藏。 false：未收藏。 status Integer 参数解释： 仓库状态。 取值范围: 0：仓库正常创建成功。 1：仓库创建中。 2：创建失败。 3：仓库冻结。 4：仓库已经关闭。 updated_at String 参数解释： 更新时间。 取值范围: 字符串。 userRole Integer 参数解释： 用户在仓库中的权限。 取值范围: 20：只读成员 30：普通成员 40：管理员 visibility_level Integer 参数解释： 可见范围。 取值范围: 0，私有仓库 20，公有仓库 web_url String 参数解释： web url 路径，访问它将跳转至仓库详情页。 取值范围: 字符串。

响应示例 状态码： 200 OK { "result" : { "total" : 2, "users" : [ { "user_id" : "5836", "name" : "repo", "domain_name" : "repo", "description" : null, "enabled" : null, "role" : 40, "domain_id" : "159b65b41ead484d8ddff250a4731781", "email" : null }, { "user_id" : "6057", "name" : "repo", "domain_name" : "repo", "description" : null, "enabled" : null, "role" : 30, "domain_id" : "159b65b41ead484d8ddff250a4731781", "email" : null } ] }, "status" : "success"}

URI GET /v1/repositories/{repository_uuid}/members 表1 路径参数 参数 是否必选 参数类型 描述 repository_uuid 是 String 参数解释： 仓库UUID(由CreateRepository接口返回) 约束限制： 必传。 取值范围： 可包含数字、字母，长度32位。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 page_index 否 Integer 参数解释： 第几页。 约束限制： 不涉及。 取值范围： 数字。 默认取值： 不涉及。 page_size 否 Integer 参数解释： 每页显示size。 约束限制： 不涉及。 取值范围： 数字。 默认取值： 不涉及。 subject 否 String 参数解释： 搜索关键字，模糊匹配用户名称、用户昵称、租户名称。 约束限制： 不涉及。 取值范围： 长度限制128个字符。 默认取值： 不涉及。

响应示例 状态码： 200 OK { "result" : { "hooks" : [ { "id" : 2111600786, "project_id" : 2111615967, "created_at" : "2021-11-09 16:35:15", "enable_ssl_verification" : false, "push_events" : true, "tag_push_events" : false, "repository_update_events" : false, "merge_requests_events" : false, "issues_events" : false, "note_events" : false, "pipeline_events" : false, "wiki_page_events" : false } ] }, "status" : "success"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 接口调用时，响应错误。 取值范围： 无。 result RepoListHook object 参数解释： 接口调用的响应结果。 取值范围： 无。 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表5 Error 参数 参数类型 描述 code String 参数解释： 调用此接口失败时返回的错误码。 取值范围： CH.010117，表示指定仓库不存在，您需要检查请求参数是否有效。 CH.051020，表示查询仓库Webhook失败，您需要检查Webhook ID是否正确。 message String 参数解释： 调用此接口失败时返回的提示信息。 表6 RepoListHook 参数 参数类型 描述 hooks Array of RepoHook objects 仓库Webhook列表 表7 RepoHook 参数 参数类型 描述 id Integer Webhook ID project_id Integer 仓库ID created_at String Webhook创建的时间 enable_ssl_verification Boolean 是否使用ssl验证 push_events Boolean 是否触发push_events事件 tag_push_events Boolean 是否触发tag_push_events事件 repository_update_events Boolean 是否触发repository_update_events事件 merge_requests_events Boolean 是否触发merge_requests_events事件 issues_events Boolean 是否触发issues_events事件 note_events Boolean 是否触发note_events事件 pipeline_events Boolean 是否触发pipeline_events事件 wiki_page_events Boolean 是否触发wiki_page_events事件

URI GET /v1/repositories/{group_name}/{repository_name}/hooks 表1 路径参数 参数 是否必选 参数类型 描述 group_name 是 String 参数解释： 项目ID（克隆地址中域名后面仓库名前的一段 示例：git@repo.alpha.devcloud.intest.com:2bc940921d964b86951950f5de1axxxx/testword.git 项目ID：2bc940921d964b86951950f5de1axxxx） 约束限制： 不涉及。 取值范围： 只能由数字和字母组成，且长度为32个字符。 默认取值： 不涉及。 repository_name 是 String 参数解释： 仓库名 约束限制： 不涉及。 取值范围： 只能由中文字符、英文字母、数字及“_”、“-”、“.”组成，且长度为[2-255]个字符。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 hook_id 否 String 参数解释： Webhook ID 约束限制： 不涉及。 取值范围： 只能由数字组成，且范围为0-2147483647。 默认取值： 不涉及。

响应示例 状态码： 200 OK { "result" : { "total" : 1, "merge_requests" : [ { "iid" : 1, "description" : "merge \"branch123\" into \"master\"\n新建文件 dsadsad11", "created_at" : "2021-12-08T16:34:49.000+08:00", "title" : "tesafrds.", "source_branch" : "branch123", "updated_at" : "2021-12-08T16:39:24.000+08:00", "id" : 6670, "state" : "opened", "closed_at" : "2021-12-08T16:34:50.000+08:00", "author" : { "name" : "repo", "id" : 1234, "state" : "active", "username" : "e0c068bf68c44bfab87b763ff85da277" }, "target_branch" : "master", "merge_status" : "can_be_merged", "devcloud_source_branch" : "branch123", "merge_request_assignee_list" : [ { "name" : "示例账号", "id" : 3333, "state" : "active", "username" : "a618e34bd5704be3ae3395dfede06041" }, { "name" : "示例账号", "id" : 6747, "state" : "active", "username" : "42dd0277cfb048dea856e4ee352e937d" } ] } ], "merged" : 0, "closed" : 0, "opened" : 1 }, "status" : "success"}

URI GET /v2/repositories/{repository_id}/merge_request 表1 路径参数 参数 是否必选 参数类型 描述 repository_id 是 Integer 参数解释： 仓库短ID，对应产品界面的“Repository ID”。 约束限制： 必传。 取值范围： 0-2147483647 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 state 否 String 参数解释： 合并请求状态。 约束限制： 无。 取值范围： 取值为以下类型中的一种： opened : 开启中的合并请求。 closed：已关闭的合并请求。 merged：已合并的合并请求。 locked：已锁定的合并请求。 all：所有状态的合并请求。 默认取值： all：所有状态的合并请求 page 否 String 参数解释： 分页页数。 约束限制： 不涉及。 取值范围： 正整数范围内的有效页数。 默认取值： 1 per_page 否 Integer 参数解释： 分页大小。 约束限制： 不涉及。 取值范围： 0-2147483647 默认取值： 20 search 否 String 参数解释： 搜索合并中标题或描述包含的字符串。 约束限制： 不涉及。 取值范围： 字符串长度范围为[0,100]。 默认取值： 不涉及。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误码。 result MergeResult object 参数解释： 响应结果。 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表5 Error 参数 参数类型 描述 code String 参数解释： 错误码。 取值范围： 符合错误码格式字符串，长度[0,100]。 message String 参数解释： 错误信息。 取值范围： 不涉及。 表6 MergeResult 参数 参数类型 描述 closed Double 参数解释： 已关闭的合并请求数量。 取值范围： 0-2147483647 merge_requests Array of MergeRequestsItem objects 参数解释： 合并请求列表详情。 merged Double 参数解释： 已合并的合并请求数量。 取值范围： 0-2147483647 opened Double 参数解释： 开启中的合并请求数量。 取值范围： 0-2147483647 total Double 参数解释： 所有的合并请求数量。 取值范围： 0-2147483647 表7 MergeRequestsItem 参数 参数类型 描述 author Author object 参数解释： 合并请求作者信息。 closed_at String 参数解释： 合并请求的关闭时间。 created_at String 参数解释： 合并请求的创建时间。 description String 参数解释： 合并请求的描述信息。 devcloud_source_branch String 参数解释： 合并请求的源分支名。 id Double 参数解释： 合并请求的ID。 取值范围： 0-2147483647 iid Double 参数解释： 当前仓库内合并请求的序列ID。 取值范围： 0-2147483647 merge_request_assignee_list Array of Author objects 参数解释： 合并请求的检视人信息。 merge_status String 参数解释： 合并请求是否可以合并。 取值范围： can_be_merged：可以合并。 cannot_be_merged：不可以合并。 unchecked：未检查。 cannot_be_merged_recheck: 不可合并，检查中。 source_branch String 参数解释： 合并请求的源分支名。 state String 参数解释： 合并请求状态。 取值范围： 取值为以下类型中的一种： opened : 开启中的合并请求。 closed：已关闭的合并请求。 merged：已合并的合并请求。 locked：已锁定的合并请求。 target_branch String 参数解释： 合并请求的目标分支名。 title String 参数解释： 合并请求的标题。 updated_at String 参数解释： 合并请求的最后更新时间。 表8 Author 参数 参数类型 描述 id Double 参数解释： 用户ID。 name String 参数解释： 用户名称。 state String 参数解释： 用户状态。 username String 参数解释： 用户IAM ID。 avatar_url String 参数解释： 头像url。 web_url String 参数解释： web url。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result TagList object 响应结果 status String 响应状态 表4 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表5 TagList 参数 参数类型 描述 tags Array of Tag objects 指定仓库的标签列表 total Integer 指定仓库的标签总数 表6 Tag 参数 参数类型 描述 is_double_name Boolean 是否与分支重名 name String 标签名 最小长度：1 最大长度：260

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释： 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 表3 请求Body参数 参数 是否必选 参数类型 描述 template_type 是 String 模板类型 code_title 否 String 代码模板名称 creator_name 否 String 创建者名称 code_description 否 String 代码模板描述 languages 否 Array of strings 模板语言 plateform 否 Array of strings 模板平台 entertype 否 Array of strings 模板类型

请求示例 PUT https://{endpoint}/v2/repositories/{repository_uuid}/template-status{"template_type": "SHARE", "code_title": "exampleTitle", "creator_name": "exampleName", "code_description": "exampleDescription", "languages": ['Java'], "plateform": ['Console'], "entertype": ['AI']}

响应示例 状态码： 200 OK { "result" : [ { "id" : "85a0a9d5c6e43bc9c3e443ac01f789e24eeef02b", "title" : "some commit message", "message" : "some commit message", "short_id" : "85a0a9d5", "author_name" : "repo", "author_email" : null, "committer_name" : "repo", "committer_email" : null, "created_at" : "2021-09-26T03:44:51.000Z", "parent_ids" : [ "5c114bb316dff4d4a046e09a5c44c816f2433140" ], "committed_date" : "2021-09-26T03:44:51.000Z", "authored_date" : null }, { "id" : "5c114bb316dff4d4a046e09a5c44c816f2433140", "title" : "更新README.md", "message" : "更新README.md", "short_id" : "5c114bb3", "author_name" : "repo", "author_email" : null, "committer_name" : "repo", "committer_email" : null, "created_at" : "2021-08-26T12:02:58.000Z", "parent_ids" : [ "646fc72bd87eb02e1e84bf3b82179c7f6d22c2c2" ], "committed_date" : "2021-08-26T12:02:58.000Z", "authored_date" : null } ], "status" : "success"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误码 result Array of CommitInfo objects 参数解释： 响应结果 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表5 Error 参数 参数类型 描述 code String 参数解释： 错误码 取值范围： 符合错误码格式字符串，长度[0,100] message String 参数解释： 错误信息 取值范围： 不涉及 表6 CommitInfo 参数 参数类型 描述 id String 参数解释： 提交对应的SHA id short_id String 参数解释： 提交对应的短SHA id title String 参数解释： 提交标题 author_name String 参数解释： 作者 author_email String 参数解释： 作者邮箱 committer_name String 参数解释： 提交作者 committer_email String 参数解释： 提交作者邮箱 created_at String 参数解释： 创建时间 message String 参数解释： 提交信息 parent_ids Array of strings 参数解释： 父提交id committed_date String 参数解释： 提交时间 authored_date String 参数解释： 作者提交时间

URI GET /v2/projects/{repo_id}/repository/commits 表1 路径参数 参数 是否必选 参数类型 描述 repo_id 是 Integer 参数解释： 仓库短id 约束限制： 必传 取值范围： 0-2147483647 默认取值： 不涉及 表2 Query参数 参数 是否必选 参数类型 描述 ref_name 否 String 参数解释： 仓库的branch名或tag名，如果为空则查询默认分支 约束限制： 无 取值范围： 最小长度：1 最大长度：200 默认取值： 默认分支 since 否 String 参数解释： 在此日期之后或当天提交，格式 YYYY-MM-DDTHH:MM:SSZ 约束限制： 无 取值范围： 不涉及 默认取值： 无 until 否 String 参数解释： 在此日期之前或当天提交，格式 YYYY-MM-DDTHH:MM:SSZ 约束限制： 无 取值范围： 不涉及 默认取值： 无 path 否 String 参数解释： 文件路径 约束限制： 无 取值范围： 不涉及 默认取值： 无 all 否 Boolean 参数解释： 是否检索仓库中每个提交 约束限制： 无 取值范围： 不涉及 默认取值： 无 with_stats 否 Boolean 参数解释： 有关每个提交的统计信息是否添加到响应中 约束限制： 无 取值范围： 不涉及 默认取值： 无 page 否 Integer 参数解释： 分页索引。 约束限制： 无 取值范围： 最小值：1 最大值：2147483647 默认取值： 1 per_page 否 Integer 参数解释： 每页条目数 约束限制： 无 取值范围： 最小值：1 最大值：100 默认取值： 100

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result BranchResponse object 响应结果 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 BranchResponse 参数 参数类型 描述 branches Array of BranchesItem objects 分支信息 total Double 总数 表7 BranchesItem 参数 参数类型 描述 commit CommitV2 object 提交信息 diverging_commit_counts DivergingCommitCounts object 提交差异数量 name String 分支名 表8 CommitV2 参数 参数类型 描述 committed_date String 提交时间 committer_name String 提交者 id String 提交id message String 提交信息 short_id String 提交短id title String 提交标题 表9 DivergingCommitCounts 参数 参数类型 描述 ahead Double 领先提交数 behind Double 滞后提交数

响应示例 状态码： 200 OK { "result" : { "total" : 1, "branches" : [ { "name" : "master", "commit" : { "id" : "2912b8f2328e798f7d544272ffaebfccccb598ab", "title" : "Initial commit", "message" : "Initial commit", "committed_date" : "2021-12-06T09:24:50.000+08:00", "short_id" : "2912b8f2", "committer_name" : "repo" }, "diverging_commit_counts" : { "behind" : 0, "ahead" : 0 } } ] }, "status" : "success"}

响应示例 状态码： 200 OK { "result" : [ { "diff" : "@@ -1,4 +1,7 @@\n y_mr_0721\n+\n+\n+\n edwwd\n # css \n **hhrh**", "old_path" : "README.md", "new_path" : "README.md", "a_mode" : "100644", "b_mode" : "100644", "new_file" : false, "renamed_file" : false, "deleted_file" : false } ], "status" : "success"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error Error object 参数解释： 响应错误码 result Array of DiffCommitInfo objects 参数解释： 响应结果 status String 参数解释： 调用此接口的响应状态。 取值范围： success，表示接口调用成功。 failed，表示接口调用失败。 表4 Error 参数 参数类型 描述 code String 参数解释： 错误码 取值范围： 符合错误码格式字符串，长度[0,100] message String 参数解释： 错误信息 取值范围： 不涉及 表5 DiffCommitInfo 参数 参数类型 描述 old_path String 参数解释： 变更前文件路径 new_path String 参数解释： 变更后文件路径 a_mode String 参数解释： 变更前文件模式 b_mode String 参数解释： 变更后文件模式 new_file Boolean 参数解释： 此次变更是否新增文件 renamed_file Boolean 参数解释： 此次变更是否重命名文件 deleted_file Boolean 参数解释： 此次变更是否删除文件 diff Boolean 差异信息