华为云用户手册

变更须知 变更云服务器规格时，用户不能选择已售罄的CPU和内存资源。 云服务器规格（CPU或内存）变小，会影响云服务器的性能。 当云硬盘状态为“正在扩容”时，不支持变更所挂载的云服务器规格。 Windows操作系统的云服务器，执行变更规格操作前建议您参考磁盘脱机怎么办？修改Windows操作系统SAN策略，避免变更规格后磁盘处于脱机状态。 变更规格前请先将云服务器关机，或根据页面提示勾选“系统自动关机后变更规格”。

变更前准备 变更规格后，可能会出现网卡漂移现象，如果对网卡有依赖，请在变更规格前做如下操作： Linux系统： 在云服务器中执行以下命令，删除网络规则目录下，文件名同时包含persistent和net的规则文件 rm -fr /etc/udev/rules.d/*net*persistent*.rules rm -fr /etc/udev/rules.d/*persistent*net*.rules Windows系统： 在云服务器中删除如下注册表下的目录。 “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\NetworkList\Profiles” “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\NetworkList\Signatures\Unmanaged” 图1 注册表

本地使用Windows操作系统 如果本地主机为Windows操作系统，可以按照下面方式登录云服务器。 以下示例演示了SSH密码方式连接Linux实例的操作步骤。 图1 SSH密码方式连接Linux实例 下面步骤以PuTTY为例。 在以下路径中下载PuTTY和PuTTYgen。 https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html 运行PuTTY。 单击“Session”。 Host Name (or IP address)：输入云服务器的弹性公网IP。 Port：输入 22。 Connection Type：选择 SSH。 Saved Sessions：任务名称，在下一次使用putty时就可以单击保存的任务名称，即可打开远程连接。 图2 单击“Session” 单击“Window”，在“Translation”下的“Received data assumed to be in which character set:”选择“UTF-8”。 单击“Open”。 如果首次登录云服务器，PuTTY会显示安全警告对话框，询问是否接受服务器的安全证书。单击“是”将证书保存到本地注册表中。 建立到云服务器的SSH连接后，根据提示输入用户名和密码登录云服务器。 如果是公共镜像（包括CoreOS），首次登录时，登录用户名、密码如下： 用户名：root 密码： 购买云服务器 时，您设置的密码

前提条件 云服务器状态为“运行中”。 已获取Windows云服务器用户名和密码，忘记密码请参考在控制台重置密码。 云服务器已经绑定弹性公网IP，绑定方式请参见绑定弹性公网IP。 所在安全组入方向已开放3389端口，配置方式请参见配置安全组规则。 已安装Microsoft Remote Desktop for Mac或其他macOS系统适用的远程连接工具。下载Microsoft Remote Desktop for Mac。 微软官方已停止提供Remote Desktop客户端的下载链接，您可单击Microsoft Remote Desktop Beta下载Beta版本使用。

操作步骤 启动Microsoft Remote Desktop。 单击“Add Desktop”。 图1 Add Desktop 在“Add PC”页面，设置登录信息后。 PC name：输入需要登录的Windows实例的弹性公网IP地址。 User account：在下拉列表中选择“Add user account”。 弹出“Add user account”对话框。 输入Windows实例账号“administrator”，并输入实例的登录密码，单击“Add”。 图2 输入登录信息 图3 保存填写的登录信息 在“Remote Desktop”页面，双击需要登录的Windows实例图标。 图4 登录Windows实例 确认信息后，单击“CONNECT”。 至此，您已经登录Windows实例。 图5 登录成功

登录方式概述 请根据需要选择登录方式，登录云服务器。 表1 Linux云服务器登录方式一览 云服务器操作系统 本地主机操作系统 连接方法 条件 Linux Windows （推荐使用）使用控制台提供的CloudShell登录云服务器。 使用CloudShell登录云服务器。 云服务器绑定弹性公网IP。 （通过内网登录云服务器时可以不绑定弹性公网IP，例如VPN、云专线等内网网络连通场景。） Windows 使用Putty、Xshell等远程连接工具登录云服务器。下载Putty。 SSH密码方式登录Linux云服务器。 说明： 使用Xshell远程连接工具时，请先在Xshell官网下载软件包。 移动设备 使用Termius、JuiceSSH等SSH客户端工具登录云服务器。 在移动设备上登录Linux云服务器。 移动设备 下载华为云APP连接云服务器。 使用华为云APP连接Linux云服务器 macOS系统 使用系统自带的终端（Terminal）： macOS系统登录Linux云服务器。 Windows 使用管理控制台远程登录方式：远程登录（VNC方式）。 不依赖弹性公网IP。 登录过程中若出现无法登录云服务器情况时，请先参考以下常见问题进行排查解决。若通过排查后，仍然无法登录云服务器，请记录资源信息和问题时间，然后单击提交工单，填写工单信息，联系技术支持。

操作步骤 启动RD Client。 在“Remote Desktop”页面右上角，单击图标，选择“Desktop”。 图1 Remote Desktop 在“Add desktop”页面，设置登录信息后，单击“SAVE”。 PC name：输入需要登录的Windows实例的弹性公网IP地址。 按以下步骤设置“User name”： 单击“User name”，在下拉列表中选择“Add user account”。 弹出“Add user account”对话框。 输入Windows实例账号“administrator”，并输入实例的登录密码，单击“SAVE”。 图2 输入登录信息 图3 保存填写的登录信息 在“Remote Desktop”页面，单击需要登录的Windows实例图标。 图4 登录Windows实例 确认信息后，单击“CONNECT”。 图5 CONNECT 至此，您已经登录Windows实例。 图6 登录成功

后续处理 使用VNC方式登录HE CS 后，系统支持从本地拷贝命令行到云服务器，实现本地数据与云服务器之间的单向复制、粘贴功能。 单击页面左上角的“复制粘贴”。 图2 复制粘贴 使用快捷键Ctrl+C，在本地复制待执行的命令。 使用快捷键Ctrl+V，将命令粘贴至“复制粘贴”窗口。 单击“发送”。 将复制的数据发送至命令行窗口。 对于使用图形化界面的Linux云服务器，在使用VNC窗口提供的“复制粘贴”功能时，会小概率出现数据丢失的情况。这是由于云服务器CPU核数过低，图形化界面占用较多CPU资源导致。此时，建议您每次发送的字符数不超过5个，或者从图形化界面切换至命令行界面（也称“文本界面”），然后再使用“Input Commands”功能。

前提条件 切换操作系统前请先将云服务器关机，或根据页面提示勾选“系统自动关机后切换操作系统”。 待切换操作系统的云服务器挂载有系统盘。 切换操作系统会清除系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。 如果您使用私有镜像切换操作系统请参考《 镜像服务 用户指南》提前完成私有镜像的制作。 如果需要指定云服务器的镜像，请提前使用指定云服务器创建私有镜像。 如果需要使用本地的镜像文件，请提前将镜像文件导入并注册为云平台的私有镜像。 如果需要使用其他区域的私有镜像，请提前复制镜像。 如果需要使用其他账号的私有镜像，请提前完成镜像共享。

操作步骤 登录HECS（旧版）控制台，单击左上角的选择区域。 在待切换操作系统的云耀云服务器的操作列中，单击“切换操作系统”。 进行切换操作系统的相关设置。 勾选“立即关机”。切换操作系统前请先将云服务器关机，或根据页面提示勾选“立即关机”。 选择切换的镜像类型、操作系统和版本。 设置密码。 如果使用公共镜像切换操作系统，您可以在切换操作系统时设置密码，也可以切换后设置密码。 如果使用私有镜像切换操作系统，您可以在切换操作系统时设置密码，或者使用镜像密码。镜像密码指所创建镜像的云服务器的密码。 图1 切换操作系统 单击“确定”。 如果提示系统盘容量不足，可能是由于系统盘容量小于您选择的待切换镜像的大小。此时，您需要先扩容系统盘，再执行切换操作。 扩容系统盘的操作指导，请参见“扩容云硬盘”章节。 在“确认切换操作系统”页面，确认切换的操作系统规格无误后，阅读并勾选声明，单击“确定”。 提交切换操作系统的申请后，云服务器的状态变为“关机（操作系统切换中）”，当状态再次变为“运行中”，表示切换结束。

约束与限制 通常使用市场镜像创建的“包年/包月”云服务器不支持切换操作系统。仅部分云商店Windows操作系统不同版本之间互相切换。 “包年/包月”方式购买的云耀云服务器切换操作系统时，支持如下场景： 支持Linux操作系统之间互相切换。 支持Linux操作系统与部分云商店Windows操作系统互相切换。 支持部分云商店Windows操作系统不同版本之间互相切换。 使用私有镜像切换操作时，仅支持使用系统盘镜像或整机镜像。 云硬盘的配额需大于0。 不支持BIOS启动方式与UEFI启动方式的操作系统互相切换。

切换须知 切换操作系统后，云服务器将不再保留原操作系统，并删除原有系统盘。 切换操作系统会清除系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。 切换操作系统后，您的业务运行环境需要在新的系统中重新部署。 切换操作系统成功后云服务器会自动开机。 切换操作系统后不支持更换系统盘的云硬盘类型。 切换操作系统后云服务器IP地址和MAC地址不发生改变。 切换操作系统后，当前操作系统内的个性化设置（如DNS、主机名等）将被重置，需重新配置。 切换操作预计需等待10~20分钟完成切换操作系统。切换操作系统过程中，云服务器会显示任务状态为“切换操作系统中”。 Windows与Linux操作系统之间互相切换时： Windows系统更换为Linux系统：请安装读写Windows系统的NTFS分区工具，例如NTFS-3G等。 Linux系统更换为Windows系统：请安装可以识别ext3、ext4等分区的识别软件，例如Ext2Read、Ext2Fsd等。 云平台不推荐您将Linux系统更换为Windows系统，当Linux系统中存在LVM分区时，切换为Windows系统后可能会导致LVM逻辑分区无法识别。

Android设备上登录Linux云服务器 如果您使用Android设备，请确保已经安装了JuiceSSH。本示例中使用CentOS 7.6操作系统，通过用户名和密码进行认证。 启动JuiceSSH，单击“连接”。 图5 启动JuiceSSH 在“连接”页面单击图标。 图6 连接 在“新建连接”页面上，添加基本设置和高级设置的信息并保存。需要添加的信息如下： 昵称：指定登录会话的名称，如本例中，设置为“linux_test”。 类型：使用默认值“SSH”。 地址：输入需要登录的Linux实例的弹性公网IP地址。 按以下步骤设置认证： 单击“认证”，在下拉列表里单击“新建”。 在“新建认证”页面上，添加如下信息后，单击图标。 昵称：可选项，您可以根据需要设置一个身份名称，方便后续管理。如本示例中，设置为“linux_test”。 用户名：输入用户名“root”。 密码：单击“设置（可选）”后，输入实例的登录密码，单击“确定”。 图7 新建认证 端口：输入端口号“22”。 图8 端口号 在“连接”页面单击创建好的连接。 图9 单击连接 确认提示信息后，单击“接受”。 图10 确认提示信息 （可选）第一次连接时，JuiceSSH会提示您如何设置字体大小，如何弹出键盘等。确认信息后，单击“好的，我知道了！”。 图11 教程 至此，您已经成功登录Linux实例。 图12 登录Linux实例

VNC方式登录Windows云服务器 登录HECS（旧版）控制台，单击左上角的选择区域。 选择要登录的云服务器，单击操作列中的“远程登录”。 在弹出的“登录Windows弹性云服务器”窗口中，选择“其他方式（VNC）”单击“立即登录”。 （可选）如果界面提示“Press CTRL+ALT+DELETE to log on”，请单击远程登录操作面板上方的“Ctrl+Alt+Del”按钮进行登录。 图1 单击“Ctrl+Alt+Del” 根据界面提示，输入云服务器密码。

IOS设备上登录Linux云服务器 如果您使用iOS设备，请确保已经安装了SSH客户端工具，以Termius为例。本示例中使用CentOS 7.6操作系统，使用用户名和密码进行认证。 启动Termius，单击New Host。 图1 New Host 在SSH页面上，输入连接信息后，单击 Save。需要输入的连接信息包括： Alias：指定Host名称，如本例中，设置为ecs01。 Hostname：输入需要连接的 Linux 实例的公网IP地址。 Use SSH：打开SSH登录配置。 Host：输入需要连接的Linux实例的公网IP地址。 Port：输入端口号22。 用户名：输入用户名root。 密码：输入实例登录密码。 图2 输入连接信息 单击右上角的“Save”，保存登录信息，在Hosts页面，单击连接的名称远程连接服务器。 图3 保存登录信息 当出现如图4所示页面时，您已经成功地连接了Linux云服务器。 图4 已连接

前提条件 云服务器状态为“运行中”。 云服务器已经绑定弹性公网IP。 使用MSTSC方式通过内网登录云服务器时可以不绑定弹性公网IP，例如VPN、云专线等内网网络连通场景。 所在安全组入方向已开放3389端口。 使用的登录工具与待登录的云服务器之间网络连通。例如，默认的3389端口没有被防火墙屏蔽。 云服务器开启远程桌面协议RDP（Remote Desktop Protocol）。使用公共镜像创建的云服务器默认已打开RDP。打开RDP方法请参考开启远程桌面协议RDP。

使用MSTSC方式登录Windows云服务器 本地主机为Windows操作系统，那么可以使用Windows自带的远程桌面连接工具MSTSC登录Windows云服务器。 以下演示了使用MSTSC方式登录Windows 2012操作系统云服务器的操作步骤。 图1 MSTSC方式登录云服务器 详细操作步骤如下： 在本地主机单击“开始”菜单。 在“搜索程序和文件”中，输入“mstsc”，单击“远程桌面连接”打开远程桌面连接工具。 在“远程桌面连接”的对话框中，单击“选项”。 图2 显示选项 输入待登录的云服务器的弹性公网IP和用户名，默认为Administrator。 如需再次登录时不再重复输入用户名和密码，可勾选“允许我保存凭据”。 图3 远程桌面链接 （可选）如需在远程会话中使用本地主机的资源，请单击“本地资源”选项卡完成如下配置。 如需从本地主机复制到云服务器中，请勾选“剪贴板”。 图4 勾选剪贴板 如需从本地主机复制文件到云服务器中，单击“详细信息”，勾选“驱动器”和相应的磁盘。 图5 勾选驱动器 （可选）如需调整远程桌面窗口的大小，可以选择“显示”选项卡，再调整窗口大小。 图6 调整窗口大小 单击“确定”，根据提示输入密码，登录云服务器。 为安全起见，首次登录云服务器，需更改密码。 当您的云服务器是采用密码方式鉴权时，请直接使用创建云服务器时设置的密码进行登录。如果您忘记密码，请参见在控制台重置云耀云服务器密码。 图7 输入云服务器密码 （可选）通过远程桌面连接（Remote Desktop Protocol, RDP）方式登录云服务器后，如果需要使用RDP提供的“剪切板”功能，将本地的大文件（文件大小超过2GB）复制粘贴至远端的Windows云服务器中，由于Windows系统的限制，会导致操作失败。 具体的解决方法，请参考使用远程桌面连接方式复制文件。

操作步骤 登录HECS（旧版）控制台，单击左上角的选择区域。 系统进入云耀云服务器列表页，您可以在本页面查看您已购买的云耀云服务器，以及云耀云服务器的私有IP地址等基本信息。 在云耀云服务器列表中的右上角，输入云耀云服务器名、IP地址或ID等信息，并单击进行搜索。 图1 搜索云耀云服务器 单击待查询云耀云服务器的名称。 系统跳转至该云服务器详情页面。 查看云耀云服务器的详细信息。 您可以选择“概览/监控/安全组/云硬盘/网卡”页签，查看云服务器的基本信息、监控云服务器资源、变更云服务器安全组、为云服务器新增磁盘、添加网卡等。

前提条件 云服务器状态为“运行中”。 云服务器已经绑定弹性公网IP。 使用MSTSC方式通过内网登录云服务器时可以不绑定弹性公网IP，例如VPN、云专线等内网网络连通场景。 所在安全组入方向已开放3389端口。 使用的登录工具与待登录的云服务器之间网络连通。例如，默认的3389端口没有被防火墙屏蔽。 云服务器开启远程桌面协议RDP（Remote Desktop Protocol）。使用公共镜像创建的云服务器默认已打开RDP。打开RDP方法请参考开启远程桌面协议RDP。

本地Linux操作系统登录Windows云服务器 如果本地主机为Linux操作系统，您可以使用远程连接工具（例如rdesktop）连接Windows实例。 在本地主机下载并安装rdesktop工具。下载rdesktop。 yum -y install rdesktop 输入以下命令登录云服务器。 rdesktop -u 用户名 -p 密码 -g 分辨率 弹性公网IP地址 例如：rdesktop -u administrator -p password -g 1024*720 192.168.x.x 表1 远程登录命令参数 参数 说明 -u 用户名，Windows实例默认用户名是Administrator。 -p 登录Windows实例的密码。 -f 默认全屏，需要用 Ctrl+Alt+Enter 组合键进行全屏模式切换。 -g 分辨率，中间用星号（*）连接，可省略，省略后默认为全屏显示。例如：1024*720 弹性公网IP地址 需要远程连接的服务器IP地址。需要替换为您的Windows实例的弹性公网IP地址或 EIP 地址。

登录方式概述 请根据需要选择登录方式，登录云服务器。 表1 Windows云服务器登录方式一览 云服务器操作系统 本地主机操作系统 连接方法 条件 Windows Windows （推荐使用）使用控制台提供的RDP文件登录云服务器。 使用RDP文件登录Windows云服务器。 云服务器绑定弹性公网IP。 （通过内网登录云服务器时可以不绑定弹性公网IP，例如VPN、云专线等内网网络连通场景。） Windows 单击“开始”菜单，输入mstsc命令，打开远程桌面对话框。 远程桌面连接（MSTSC方式）。 Linux 安装远程连接工具，例如rdesktop，执行连接命令。 在Linux主机上登录Windows云服务器。 macOS系统 安装远程连接工具，例如Microsoft Remote Desktop for Mac在macOS系统上登录。 在macOS系统上登录Windows云服务器。 移动设备 安装远程连接工具，例如Microsoft Remote Desktop在移动设备上登录。 在移动设备上登录Windows云服务器。 Windows 使用管理控制台远程登录方式：远程登录（VNC方式）。 不依赖弹性公网IP。 登录过程中若出现无法登录云服务器情况时，请先参考以下常见问题进行排查解决。若通过排查后，仍然无法登录云服务器，请记录资源信息和问题时间，然后单击提交工单，填写工单信息，联系技术支持。

操作步骤 登录HECS（旧版）控制台，单击左上角的选择区域。 单击“购买云耀云服务器(旧版)”，系统进入购买页。 对云耀云服务器进行资源配置。 参数 说明 区域 请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。云服务器创建后无法更换区域，请谨慎选择。 场景镜像 云耀云服务器提供系统镜像和应用镜像供您选择。 配置 请选择您需要的实例规格。同时可以为云耀云服务器增加数据盘。 创建云耀云服务器后，默认分配一个固定的弹性公网IP。 设置密码 设置云耀云服务器的初始登录密码。Linux系统用户名默认为“root”；Windows系统用户名默认为“Administrator”。 勾选此选项：在购买云耀云服务器后，请先设置初始登录密码再登录服务器。默认勾选此选项。 去勾选此选项：在购买时设置初始登录密码。 增值服务（可选） 云耀云服务器为您免费提供“性能助手免费诊断”、“主机安全（基础版）”、“ 云监控 ”增值服务。 购买时长 单次购买最短为1个月，最长为5年。 支持自动续费功能。勾选后，在云耀云服务器到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。 按月购买的资源：每次续费1个月 ，次数不限。 按年购买的资源：每次续费1年，次数不限。 购买数量 设置您购买的云耀云服务器数量。 协议 请阅读并勾选协议。 单击“立即购买”，并根据界面提示完成支付。 将鼠标悬浮于配置费用金额上，您可了解配置费用。 单击“返回HECS(云耀云服务器)控制台”可查看到您购买的云耀云服务器。

操作步骤 登录HECS（旧版）控制台，单击左上角的选择区域。 选择要登录的云服务器，单击操作列中的“远程登录”。 在弹出的“登录Linux云服务器”窗口中，单击“CloudShell登录”。 在CloudShell界面配置云服务器信息。 首次登录，默认会打开CloudShell配置向导，输入云服务器的相关参数进行连接。 您可以选择使用弹性公网IP或私有IP登录云服务器。 若勾选云服务器的公网IP（弹性公网IP）。 在CloudShell配置向导中设置云服务器的端口（默认22）、用户名、认证方式、密码（或密钥）等参数。 单击“连接”登录云服务器。 如果单击“连接”没有反应，可能是云服务器未设置登录密码或密码错误，请重置密码后重新登录。 图1 CloudShell配置向导（公网IP） 连接成功后，CloudShell界面提示如下。 图2 操作结果 若勾选云服务器的私网IP（私有IP）。 单击“跳转”。 图3 CloudShell配置向导（私网IP）跳转 单击“立即授权”。 图4 服务授权 在新的CloudShell配置向导中设置云服务器的端口（默认22）、用户名、认证方式、密码（或密钥）等参数。 图5 CloudShell配置向导（私网IP） 单击“连接”登录云服务器。 如果单击“连接”没有反应，可能是云服务器未设置登录密码或密码错误，请重置密码后重新登录。 连接成功后，CloudShell界面提示如下。 图6 操作结果

怎样使用主机安全服务 您在使用主机安全服务前，需要先在云耀云服务器上安装Agent。针对新创建的云服务器和已有的云服务器，我们提供了不同的安装方式： 场景一：新创建云服务器 购买云耀云服务器，选择镜像时，如果勾选了“主机安全基础版”，HSS会自动为该云服务器安装Agent并开启基础版防护。 若基础版不满足要求，您可以购买其他版本配额，获取更高级的防护，且不需要重新安装Agent。 图1 选择主机安全基础版 场景二：未配置主机安全的云服务器 对于已经创建完成的云耀云服务器，可能由于创建时尚未支持主机安全服务、或未勾选“主机安全基础版”，如需使用主机安全，您需要手动安装Agent。

什么是主机安全 主机安全服务（Host Security Service，HSS）是提升服务器整体安全性的服务，通过主机管理、风险防御、入侵检测、安全运营、网页防篡改功能，可全面识别并管理云服务器中的信息资产，实时监测云服务器中的风险，降低服务器被入侵的风险。 使用主机安全需要在云服务器中安装Agent。安装Agent后，您的云服务器将受到HSS云端防护中心全方位的安全保障，在安全控制台可视化界面上，您可以统一查看并管理同一区域内所有主机的防护状态和主机安全风险。 更多关于主机安全服务的使用，请参见主机安全。

创建MR检查任务并获取任务ID 以下为新建全量任务的请求示例。 增量检查任务依赖于全量任务，所以需要先创建全量任务。 CreateTask：POST /v2/{project_id}/task{ "git_url": "https://codehub-dg-g.huawei.com/userID/CloudBuildTest01.git", #如果使用CodeArts Repo代码仓，需具备Repo仓的相关权限且需填写ssh地址 "git_branch": "master", "language": [ "JAVA" ], "task_type": "full", #任务类型 "username": "zxxxw", #用户名，仅在三方仓场景下使用 "access_token": "f2xxxb0", #密码或用户token，仅在三方仓场景下使用 "endpoint_id": "fxxxxxsz" #服务扩展点ID} 新建全量任务的返回结果。响应值为全量任务的任务ID，即创建增量任务需要用到的“parent_task_id”。 创建全量任务后，可在华为云对应局点账号下的项目中，查看到新建的代码检查任务。 新建MR增量代码检查任务的请求示例。 CreateTask：/v2/{project_id}/task{ "git_url": "https://codehub-dg-g.huawei.com/userID/CloudBuildTest01.git",#如果使用CodeArts Repo代码仓，需具备Repo仓的相关权限且需填写ssh地址 "git_branch": "master", "language": [ "JAVA" ], "task_type": "inc", #任务类型 "inc_config": { "parent_task_id": "8cxxx94", #全量任务id，增量任务挂载在全量任务下 "git_source_branch": "dev003", #源分支 "git_target_branch": "dev002", #目标分支 "merge_id": "4", #MR编号，用于检查插件拉取增量代码 "event_type": "merge_request", #事件类型，MR请求 "action": "open", #状态，open为MR开启状态 "title": "测试" #任务标题，根据需求填写 }} 新建增量任务的返回结果。 响应值为增量任务的任务ID，该ID在任务列表界面不可见，仅用于通过API接口创建、执行和查询MR任务的场景。

执行并查询MR任务状态 执行MR任务的请求示例。 RunTask：POST /v2/tasks/{task_id}/run{} “task_id”中填写创建MR检查任务并获取任务ID中获取的MR任务ID以执行检查任务。 请求体参数，空传即可。 执行MR任务的返回结果。 响应值为MR任务对应的执行ID，也就是1个任务1次执行产生的1个job的ID。 轮询任务执行状态请求示例。 ShowProgressDetail：GET /v2/tasks/{task_id}/progress “task_id”中填入MR任务ID以查询任务执行状态，任务状态0表示检查中，1表示检查失败，2表示检查成功，3表示任务中止。 轮询任务执行状态的返回结果。

操作流程 表1 操作流程 流程 说明 创建代码检查任务所属项目 为本实践新建项目。 新建通用Git服务扩展点 本实践检查第三方代码仓的代码质量，代码检查服务需通过CodeArts提供的扩展插件连接到第三方代码仓。 获取服务扩展点ID 获取服务扩展点ID，在使用API时需要填写。 创建MR检查任务并获取任务ID 创建代码检查任务并获取任务ID。 执行并查询MR任务状态 通过执行脚本，执行代码检查任务。 查询缺陷详情 通过API查询缺陷详情。

应用场景 在用户实际的使用场景中，用户往往有构建自己的代码质量管控平台，集成代码检查及其他检查项的需求。并且在用户的应用场景中，MR合入过程中的质量监控是一个高频应用场景。 本示例介绍如何通过调用CodeArtsCheck API方式，执行MR增量代码检查并获取检查结果。通过调用CodeArtsCheck API可以不使用华为云前端，从而构建自己的全流程代码质量管控平台，同时也可以实现对非Codearts Repo代码仓的门禁级检查。本示例将以通用Git为例，进行方案介绍。

下载KooCLI工具并获取代码检查API的调用命令 访问华为云命令行工具服务KooCLI文档页面。 根据本地电脑的系统版本号下载对应版本的KooCLI工具。 访问代码检查API调试页面。 选择实际使用的Region和填写创建通用Git代码检查任务并获取任务ID中查询到的任务ID，其中hcloud CodeCheck RunTask --cli-region="cn-north-4" --task_id="9fd08c41a9824a69afdb9aca17590e29"即为生成的调用命令。 图2 生成API调用命令 参考4，依次获得查询任务执行状态（ShowProgressDetail）、查询缺陷概要（ShowTaskDetail）API的调用命令。