华为云用户手册

合作方接入点 华为云与中信网络在部分城市部署了网络预连接，您可以通过表3的中信网络接入点连接至华为云。 如需更多信息或支持，可提交工单或联系销售经理。 表3 合作方接入点 城市 地址 长沙 湖南省长沙市雨花区人民东路38号，东一宾馆4楼 天津 天津滨海高新区华苑产业区海泰华科八路6号四层A区403号 福州 象园路33号耀龙审计局综合大楼3层 南京 江苏省南京市中山北路283号江苏物资大厦17楼 合肥 合肥市高新区合欢路与香樟大道交叉口合肥有线电视宽带网络有限公司4层 济南 经七路纬五路75号5楼 重庆 重庆市九龙坡区石坪桥横街66号九龙大厦副楼5层 成都 成都市草市街2号光大国际大厦四层

华为云接入点 表1 中国区域接入点信息 区域 接入点 运营商 位置区域信息 华北-北京四 北京-亚太 中立 北京亦庄亚太 北京-酒仙桥 鹏博士 北京恒通国际创新园 北京-汇天 中立 北京汇天云端产业园 北京-中金 中立 北京经开区中金数据 廊坊-万国 中立 廊坊万国数据 廊坊-润泽 电信 廊坊润泽信息港 廊坊-华为基地 华为 廊坊华为生产基地 武汉-武钢 中立 武汉武钢数据产业园 武汉-武研所 华为 武汉华为研究所 华北-乌兰察布一 乌兰察布-集宁 华为 乌兰察布华为云数据中心 乌兰察布-玫瑰营 华为 乌兰察布玫瑰营基地 华东-上海一 苏州-万国 中立 苏州万国数据中心 苏州-国科 联通 苏州国科数据中心 苏州-苏研所 华为 苏州华为研究所 苏州-坤汇 中立 苏州坤汇网络 苏州-吴江 移动 苏州移动数据中心 上海-万国 中立 上海万国数据中心 上海-宝信 移动 上海宝信数据中心 上海-光环 中立 上海光环新网数据中心 杭州-杭钢 中立 杭州杭钢云数据中心 杭州-杭研所 华为 杭州华为研究所 华东-上海二 上海-万国 中立 上海万国数据中心 上海-光环 中立 上海光环新网数据中心 上海-宝信 移动 上海宝信数据中心 华东二 芜湖-江北 华为 芜湖江北数据中心 芜湖-三山 华为 芜湖三山数据中心 芜湖-职教 华为 芜湖职教数据中心 华东-青岛 青岛-红岛 移动 红岛移动数据中心 华南-广州 广州-云埔 电信 广州云埔数据中心 广州-华新园 中立 华南创新材料园 广州-大学城 中立 广州大学城 广州-明美 联通 广州明美电子 广州-化龙 联通 伟鑫创新产业园 深圳-宝德 中立 深圳观澜高新园 深圳-福田 中立 福田中鹏云 深圳-南山 中立 南山特发港 深圳-弈峰 中立 电达谷源产业园 东莞-团泊洼 华为 东莞松山湖华为 华南-广州-友好用户环境 广州-化龙 联通 伟鑫创新产业园 广州-云埔 电信 广州云埔数据中心 西南-贵阳一 成都-成研所 华为 成都华为研究所 贵阳-贵安移动 移动 贵安电子信息产业园 贵阳-七星湖 华为 贵安云上屯数据中心 贵阳-高端园 华为 贵阳高端园区 中国-香港 香港-沙田 电信 沙田火炭新鸿基 香港-西贡移动 移动 将军澳移动环球网络 香港-西贡GS 电信 将军澳GlobalSwitch 香港-荃湾 中立 香港-荃湾-MEGA 表2 国际区域接入点信息 区域 接入点 运营商 亚太-曼谷 曼谷-NTT NTT 曼谷-TRUE TRUE 亚太-新加坡 新加坡-Equinix Equinix 新加坡-Global Switch Global Switch 新加坡-1Net 1-Net 新加坡-Singtel Singtel 新加坡-Telin3 Telin 新加坡-STT STT 亚太-雅加达 雅加达-DCI DCI 雅加达-EDGE EDGE 亚太-马尼拉 马尼拉-GBP Globe 马尼拉-Digital Halo Digital Halo 非洲-约翰内斯堡 尼日利亚-拉各斯-Medallion Medallion 约翰内斯堡-IS Parklands Internet Solutions Parklands 约翰内斯堡-Teraco Teraco 约翰内斯堡-DPA Vodacom 约翰内斯堡-ADC ADC 约翰内斯堡-MTN MTN 非洲-开罗 开罗-Xceed Xceed 拉美-墨西哥城一 墨西哥-Ixtlahuaca Ixtlahuaca 墨西哥-Tultitlan KIO MEX 5 拉美-墨西哥城二 墨西哥-Tultitlan KIO MEX 5 墨西哥-Scala Scala 拉美-圣保罗一 圣保罗-Equinix Equinix 圣保罗-ODATA ODATA 圣保罗-Scala Scala 圣保罗-VIVO Telefonica 秘鲁-利马一 利马-TIC Telefonica 拉美-圣地亚哥 圣地亚哥-Paine Paine 圣地亚哥-Claro Claro 土耳其-伊斯坦布尔 伊斯坦布尔-Turkcell Turkcell 伊斯坦布尔-NGN NGN 中东-利雅得 利雅得-STC Khurais STC Khurais 利雅得-Remal Remal

退订自建专线接入物理连接 操作场景 用户选择自建专线物理连接接入后，如果不需要使用物理连接时，可以申请退订物理连接。 目前只有状态为“正常”的专线订单能够由用户自己退订，创建中的专线需要在创建流程完成后再退订。 操作步骤 进入云专线物理连接列表页。 在页面左上角单击，选择区域和项目。 在物理连接列表中，单击“操作”列的“退订”，系统跳转至“退订管理”页面。 在退订列表中，单击需要退订的物理连接“操作”列的“退订资源”。 在退订资源页面中，选择退订原因，确认退订金额并勾选“我已确认本次退订金额和相关费用”。 单击“退订”，完成物理连接的退订。

专线接入有哪些网络要求？ 您必须使用单模的1GE、10GE、40GE或100GE的光模块与华为云的接入设备对接。同时，需要提前与华为云专线POP点对齐LC、波长、距离等关键参数。光模块参数举例：1GE、LC 单模、1310nm、10KM。 必须禁用端口的自动协商功能，同时必须手动配置端口速率和全双工模式。 必须跨整个连接 (包括中间设备) 支持 802.1Q VLAN 封装。 可以支持BGP或者静态路由对接，您的设备须支持边界网关协议（BGP）和BGP MD5认证或支持静态路由。 (可选) 您可以在网络上配置双向转发检测 (BFD)。 在物理连接层上支持的最大传输单位 (MTU) 高达 1522 字节 (14 字节以太网标头 + 4 字节 VLAN 标记 + 1500 字节 IP 数据报 + 4 字节帧检测序列)。推荐参数值：1500。 云上云下建议使用私网IP地址，且互通的IP网段不能冲突。 父主题： 产品咨询

云专线的延迟和丢包率是多少？ 华为云云专线服务支持通过安装云专线监控插件检测云专线端到端的网络质量，主要包含网络时延和丢包率两个指标。 云专线插件分为两种： dc-nqa-collector：用于监控自动化专线，探测远端子网的时延和丢包率。 history-dc-nqa-collector：用于监控手工专线，探测远端子网的时延和丢包率。 详细请参考安装云专线指标采集插件。 自动化专线，云专线资源包括物理连接、虚拟网关和虚拟接口，路由配置自动下发。目前大多数Region的云专线都属于自动化专线。 手工专线，云专线资源只有物理连接，没有虚拟网关和虚拟接口，需手工配置路由等信息。目前有部分Region的存量资源属于手工专线。 专线网关经过运营商专线到用户机房的延迟和丢包率请联系专线提供商确认提供。 提供数据为理论值，实测值以实际监控为准。 父主题： 产品咨询

云专线中的网络互联IP地址是什么意思？ 本端网关，指华为云侧网络接口互联的IP地址，即华为云和客户线下机房对接时华为云侧设备接口的对接地址，配置后会自动下发到华为云侧网关设备。 远端网关，指客户本地数据中心侧网络互联的IP地址，即华为云和客户线下机房对接时客户线下设备接口的对接地址，配置后需要客户自己配置在客户线下设备的接口上。 本端网关与远端网关需要设置为同一网段的IP地址，一般使用30位掩码，由客户自行规划，不能与组网内的业务地址冲突。所以您需要为物理专线两端分别规划一个位于同一网段的IP地址用于本地数据中心和云上VPC之间的通信。 父主题： 产品咨询

合作方接入点 华为云与中信网络在部分城市部署了网络预连接，您可以通过表3的中信网络接入点连接至华为云。 如需更多信息或支持，可提交工单或联系销售经理。 表3 合作方接入点 城市 地址 长沙 湖南省长沙市雨花区人民东路38号，东一宾馆4楼 天津 天津滨海高新区华苑产业区海泰华科八路6号四层A区403号 福州 象园路33号耀龙审计局综合大楼3层 南京 江苏省南京市中山北路283号江苏物资大厦17楼 合肥 合肥市高新区合欢路与香樟大道交叉口合肥有线电视宽带网络有限公司4层 济南 经七路纬五路75号5楼 重庆 重庆市九龙坡区石坪桥横街66号九龙大厦副楼5层 成都 成都市草市街2号光大国际大厦四层

华为云接入点 表1 中国区域接入点信息 区域 接入点 运营商 位置区域信息 华北-北京四 北京-亚太 中立 北京亦庄亚太 北京-酒仙桥 鹏博士 北京恒通国际创新园 北京-汇天 中立 北京汇天云端产业园 北京-中金 中立 北京经开区中金数据 廊坊-万国 中立 廊坊万国数据 廊坊-润泽 电信 廊坊润泽信息港 廊坊-华为基地 华为 廊坊华为生产基地 武汉-武钢 中立 武汉武钢数据产业园 武汉-武研所 华为 武汉华为研究所 华北-乌兰察布一 乌兰察布-集宁 华为 乌兰察布华为云数据中心 乌兰察布-玫瑰营 华为 乌兰察布玫瑰营基地 华东-上海一 苏州-万国 中立 苏州万国数据中心 苏州-国科 联通 苏州国科数据中心 苏州-苏研所 华为 苏州华为研究所 苏州-坤汇 中立 苏州坤汇网络 苏州-吴江 移动 苏州移动数据中心 上海-万国 中立 上海万国数据中心 上海-宝信 移动 上海宝信数据中心 上海-光环 中立 上海光环新网数据中心 杭州-杭钢 中立 杭州杭钢云数据中心 杭州-杭研所 华为 杭州华为研究所 华东-上海二 上海-万国 中立 上海万国数据中心 上海-光环 中立 上海光环新网数据中心 上海-宝信 移动 上海宝信数据中心 华东二 芜湖-江北 华为 芜湖江北数据中心 芜湖-三山 华为 芜湖三山数据中心 芜湖-职教 华为 芜湖职教数据中心 华东-青岛 青岛-红岛 移动 红岛移动数据中心 华南-广州 广州-云埔 电信 广州云埔数据中心 广州-华新园 中立 华南创新材料园 广州-大学城 中立 广州大学城 广州-明美 联通 广州明美电子 广州-化龙 联通 伟鑫创新产业园 深圳-宝德 中立 深圳观澜高新园 深圳-福田 中立 福田中鹏云 深圳-南山 中立 南山特发港 深圳-弈峰 中立 电达谷源产业园 东莞-团泊洼 华为 东莞松山湖华为 华南-广州-友好用户环境 广州-化龙 联通 伟鑫创新产业园 广州-云埔 电信 广州云埔数据中心 西南-贵阳一 成都-成研所 华为 成都华为研究所 贵阳-贵安移动 移动 贵安电子信息产业园 贵阳-七星湖 华为 贵安云上屯数据中心 贵阳-高端园 华为 贵阳高端园区 中国-香港 香港-沙田 电信 沙田火炭新鸿基 香港-西贡移动 移动 将军澳移动环球网络 香港-西贡GS 电信 将军澳GlobalSwitch 香港-荃湾 中立 香港-荃湾-MEGA 表2 国际区域接入点信息 区域 接入点 运营商 亚太-曼谷 曼谷-NTT NTT 曼谷-TRUE TRUE 亚太-新加坡 新加坡-Equinix Equinix 新加坡-Global Switch Global Switch 新加坡-1Net 1-Net 新加坡-Singtel Singtel 新加坡-Telin3 Telin 新加坡-STT STT 亚太-雅加达 雅加达-DCI DCI 雅加达-EDGE EDGE 亚太-马尼拉 马尼拉-GBP Globe 马尼拉-Digital Halo Digital Halo 非洲-约翰内斯堡 尼日利亚-拉各斯-Medallion Medallion 约翰内斯堡-IS Parklands Internet Solutions Parklands 约翰内斯堡-Teraco Teraco 约翰内斯堡-DPA Vodacom 约翰内斯堡-ADC ADC 约翰内斯堡-MTN MTN 非洲-开罗 开罗-Xceed Xceed 拉美-墨西哥城一 墨西哥-Ixtlahuaca Ixtlahuaca 墨西哥-Tultitlan KIO MEX 5 拉美-墨西哥城二 墨西哥-Tultitlan KIO MEX 5 墨西哥-Scala Scala 拉美-圣保罗一 圣保罗-Equinix Equinix 圣保罗-ODATA ODATA 圣保罗-Scala Scala 圣保罗-VIVO Telefonica 秘鲁-利马一 利马-TIC Telefonica 拉美-圣地亚哥 圣地亚哥-Paine Paine 圣地亚哥-Claro Claro 土耳其-伊斯坦布尔 伊斯坦布尔-Turkcell Turkcell 伊斯坦布尔-NGN NGN 中东-利雅得 利雅得-STC Khurais STC Khurais 利雅得-Remal Remal

云专线支持哪些接入方式？ 华为云云专线服务从不同维度支持多种接入方式： 数据传输方式：目前华为云支持1GE、10GE、40GE、100GE的单模光口接入，不支持单纤接入。 物理连接方式：包括标准专线接入和托管专线接入。 标准专线接入：用户独占端口资源的物理连接，由用户创建，并支持用户创建多个虚拟接口。 托管专线接入：多个用户共享端口资源的物理连接，由合作伙伴创建，并且只允许用户创建一个虚拟接口。用户通过向合作伙伴申请来创建托管物理连接，需要合作伙伴为用户分配VLAN和带宽资源。 端口资源购买方式：包括自建专线接入和一站式专线接入。 自建专线接入：用户需要向运营商购买专线，华为云仅提供端口资源。通过运营商的专线将本地数据中心连接至接入点，构建混合云。 一站式接入：华为云向用户提供整合基础运营商网络资源和端口的一站式上云服务。 路由模式：包括静态路由接入和BGP接入。 静态接入方式：通过配置静态路由实现专线接入。 BGP接入方式：通过BGP动态路由协议实现更灵活和高效的专线接入。 父主题： 专线施工

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

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天）

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 删除的行数

响应参数 状态码： 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" : { "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 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"}

响应参数 状态码： 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

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 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"}

响应参数 状态码： 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。

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 表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