华为云用户手册

RAID相关特性及概念 特性/概念 解释 磁盘组和虚拟磁盘 由于现代数据中心业务量的与日俱增，单台服务器上需要运行的数据也日益增多。当单个磁盘在容量和安全性上不足以支持系统业务时，就需要将多个磁盘联合起来，对外作为一个可见的磁盘来使用，才可满足实际需要。磁盘组，就是将一组物理磁盘集合起来，作为一个整体对外体现，是虚拟磁盘的基础。 虚拟磁盘，即使用磁盘组划分出来的连续的数据存储单元，相当于一个个独立的磁盘，通过一定的配置，使其具有较单个物理磁盘更大的容量，及更高的安全性和数据冗余性。 一个虚拟磁盘可以是： 一个完整的磁盘组。 多个完整的磁盘组。 一个磁盘组的一部分。 多个磁盘组的一部分（每个磁盘组划分一部分，共同组成虚拟磁盘）。 容错 容错是指在系统出现磁盘错误或磁盘故障时，可以保证数据完整性和数据处理能力。RAID卡通过冗余的磁盘组在RAID 1、5、6、10、50、60上实现此功能。 一致性校验 针对有冗余功能的RAID 1、5、6、10、50、60，RAID卡可以对RAID组的硬盘数据进行一致性检查，对磁盘数据进行检验和计算，并与对应的冗余数据进行比较。如果发现有数据不一致的情况，会尝试做自动修复并保存错误信息。 由于RAID 0不具备冗余性，因此不支持一致性校验。 磁盘条带化 当多个进程同时访问一个磁盘时，可能会出现磁盘冲突。大多数磁盘系统都对访问次数（每秒的I/O操作）和数据传输率（每秒传输的数据量）有限制。当达到这些限制时，后面需要访问磁盘的进程就需要等待。 条带化是一种自动的将I/O的负载均衡到多个物理磁盘上的技术。条带化技术将一块连续的数据分成多个小部分并将其分别存储到不同磁盘上去。这就能使多个进程同时访问数据的多个不同部分而不会造成磁盘冲突，而且在需要对这种数据进行顺序访问的时候可以获得最大程度上的I/O并行能力。 磁盘镜像 磁盘镜像，适用于RAID 1和RAID 10，是指执行写数据的任务时，会将同样的数据同时写入两块磁盘，以实现100%的数据冗余度。由于两块磁盘上的数据完全相同，当一块磁盘故障时，数据不会丢失。另外，同一时间，两块盘上的数据是完全相同的，当一块磁盘故障时，另一块盘可以马上接替故障盘的工作。 硬盘直通 硬盘直通，即“JBOD”功能，又称指令透传，是不经过传输设备处理，仅保证传输质量的一种数据传输方式。 打开硬盘直通功能后，RAID控制器可对所连接的硬盘进行指令透传，在不配置虚拟磁盘的情况下，用户指令可以直接透传到硬盘，方便上层业务软件或管理软件访问控制硬盘。 例如，服务器操作系统安装过程中，可以直接找到挂载在RAID卡下的硬盘作为安装盘；而不支持硬盘直通的RAID卡，在操作系统安装过程中，只能找到该RAID卡下已经配置好的虚拟磁盘作为安装盘。

增加网卡 以“root”用户，使用密钥或密码登录裸金属服务器。执行如下命令： blkid | grep config-2 如果输出结果为空，请采用配置方式二；如果输出结果如下图所示，请采用配置方式一。 配置方式一： 以“root”用户，使用密钥或密码登录裸金属服务器。 进入裸金属服务器的命令行界面，查询网卡信息。 ip link 返回信息示例如下： 其中，“eth0”和“eth1”为承载VPC网络的网络设备，“eth2”和“eth3”为承载增强高速网络的网络设备。 执行以下命令，查看“/etc/udev/rules.d/”目录下是否有“80-persistent-net.rules”配置文件。 ll /etc/udev/rules.d/ | grep 80-persistent-net.rules 如果存在“80-persistent-net.rules”，且该配置文件中已存在2中查询到的除“bond0”和“lo”以外的其它所有网卡和对应的MAC地址，请执行6。 否则，继续执行4。 执行以下命令，将“/etc/udev/rules.d/70-persistent-net.rules”文件拷贝一份（文件名为“/etc/udev/rules.d/80-persistent-net.rules”）。 cp -p /etc/udev/rules.d/70-persistent-net.rules /etc/udev/rules.d/80-persistent-net.rules 如果没有“/etc/udev/rules.d/70-persistent-net.rules”文件，请直接创建“/etc/udev/rules.d/80-persistent-net.rules”文件，按如下格式填写内容： SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="4c:f9:5d:d9:e8:ac", NAME="eth0" SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="4c:f9:5d:d9:e8:ad", NAME="eth1" 设置udev规则。 将2中查询到的除“eth0”和“eth1”以外的网卡（即“/etc/udev/rules.d/70-persistent-net.rules”中未体现的网卡MAC地址和名称），写入“/etc/udev/rules.d/80-persistent-net.rules”文件中，使得裸金属服务器重启复位后，网卡名称和顺序不会发生改变。 网卡的MAC地址和名称中的字母，请使用小写字母。 vi /etc/udev/rules.d/80-persistent-net.rules 修改后的示例如下： 修改完成后，按“Esc”，输入:wq保存并退出。 执行以下命令，将网络配置文件“/etc/sysconfig/network-scripts/ifcfg-bond0”拷贝为“/etc/sysconfig/network-scripts/ifcfg-bond1”，将网络配置文件“/etc/sysconfig/network-scripts/ifcfg-eth0”拷贝为“/etc/sysconfig/network-scripts/ifcfg-eth2”和“/etc/sysconfig/network/ ifcfg-eth3”。 cp -p /etc/sysconfig/network-scripts/ifcfg-bond0 /etc/sysconfig/network-scripts/ifcfg-bond1 cp -p /etc/sysconfig/network-scripts/ifcfg-eth0 /etc/sysconfig/network-scripts/ifcfg-eth2 cp -p /etc/sysconfig/network-scripts/ifcfg-eth0 /etc/sysconfig/network-scripts/ifcfg-eth3 执行以下命令，编辑“/etc/sysconfig/network-scripts/ifcfg-eth2”和“/etc/sysconfig/network-scripts/ifcfg-eth3”，配置“eth2”设备和“eth3”设备的网络配置文件。 vi /etc/sysconfig/network-scripts/ifcfg-eth2 “eth2”按以下格式编辑： USERCTL=no MTU=8888 NM_CONTROLLED=no BOOTPROTO=static DEVICE=eth2 TYPE=Ethernet ONBOOT=yes MASTER=bond1 SLAVE=yes 其中，“BOOTPROTO”参数取值修改为“static”，“DEVICE”为对应的网络设备名称，取值即为“eth2”，“MASTER”为对应的增强高速网卡bond的名称，取值如“bond1”，其他参数可保持不变。 vi /etc/sysconfig/network-scripts/ifcfg-eth3 “eth3”按以下格式编辑（格式和规则和“eth2”一致）： USERCTL=no MTU=8888 NM_CONTROLLED=no BOOTPROTO=static DEVICE=eth3 TYPE=Ethernet ONBOOT=yes MASTER=bond1 SLAVE=yes 执行以下命令，编辑“/etc/sysconfig/network-scripts/ifcfg-bond1”。 vi /etc/sysconfig/network-scripts/ifcfg-bond1 按以下格式编辑： MACADDR=40:7d:0f:52:e3:a5 BONDING_MASTER=yes USERCTL=no ONBOOT=yes NM_CONTROLLED=no BOOTPROTO=static BONDING_OPTS="mode=1 miimon=100" DEVICE=bond1 TYPE=Bond IPADDR=10.10.10.101 NETMASK=255.255.255.0 MTU=8888 其中， “MACADDR”参数取值修改为增强高速网卡“eth2”或者“eth3”设备的MAC地址。 “BOOTPROTO”参数取值修改为“static”。 “DEVICE” 参数取值修改为“bond1”。 “IPADDR” 参数取值修改为待给“bond1”分配的IP地址（为增强高速网络规划的IP地址在没有与VPC网段冲突的情况下可任意规划，需要通过增强高速网络通信的裸金属服务器须将增强高速网络配置在同一个网段），如“10.10.10.101”。 “NETMASK”参数为给增强高速网络“bond1”配置的IP的子网掩码。 其他参数可保持不变。 修改完成后，按“Esc”，输入:wq保存并退出。 执行以下命令，启动增强高速网络端口组“bond1”。 首先启动增强高速网卡“eth2”和“eth3”设备。 ifup eth2 ifup eth3 ifup bond1 参见上述步骤，完成其他裸金属服务器的配置。 待其他裸金属服务器配置完成后，互相ping对端增强高速网络配置的同网段IP，检查是否可以ping通。 配置方式二： 以“root”用户，使用密钥或密码登录裸金属服务器。 进入裸金属服务器的命令行界面，查询网卡信息。 ip link 返回信息示例如下： 其中，MAC地址为“fa:16”开头的网卡为承载VPC网络的网络设备，如eth0，eth1；MAC地址为增强高速网卡查看方式中显示的MAC地址的网卡为承载增强高速网络的网络设备，如eth6，eth7。 执行以下命令，编辑“/etc/sysconfig/network-scripts/ifcfg-eth6”和“/etc/sysconfig/network-scripts/ifcfg-eth7”，配置“eth6”设备和“eth7”设备的网络配置文件。 vi /etc/sysconfig/network-scripts/ifcfg-eth6 “eth6”按以下格式编辑： USERCTL=no MTU=8888 NM_CONTROLLED=no BOOTPROTO=static DEVICE=eth6 TYPE=Ethernet ONBOOT=yes MASTER=bond1 SLAVE=yes 其中，“BOOTPROTO”参数取值修改为“static”，“DEVICE”为对应的网络设备名称，取值即为“eth6”，“MASTER”为对应的增强高速网卡bond的名称，取值如“bond1”，其他参数可保持不变。 vi /etc/sysconfig/network-scripts/ifcfg-eth7 “eth7”按以下格式编辑（格式和规则和“eth6”一致）： USERCTL=no MTU=8888 NM_CONTROLLED=no BOOTPROTO=static DEVICE=eth7 TYPE=Ethernet ONBOOT=yes MASTER=bond1 SLAVE=yes 执行以下命令，编辑“/etc/sysconfig/network-scripts/ifcfg-bond1”。 vi /etc/sysconfig/network-scripts/ifcfg-bond1 按以下格式编辑： MACADDR=00:2e:c7:e0:b2:37 BONDING_MASTER=yes USERCTL=no ONBOOT=yes NM_CONTROLLED=no BOOTPROTO=static BONDING_OPTS="mode=1 miimon=100" DEVICE=bond1 TYPE=Bond IPADDR=10.10.10.101 NETMASK=255.255.255.0 MTU=8888 其中， “MACADDR”参数取值修改为增强高速网卡“eth6”或者“eth7”设备的MAC地址。 “BOOTPROTO”参数取值修改为“static”。 “DEVICE” 参数取值修改为“bond1”。 “IPADDR” 参数取值修改为待给“bond1”分配的IP地址（为增强高速网络规划的IP地址在没有与VPC网段冲突的情况下可任意规划，需要通过增强高速网络通信的裸金属服务器须将增强高速网络配置在同一个网段），如“10.10.10.101”。 “NETMASK”参数为给增强高速网络“bond1”配置的IP的子网掩码。 其他参数可保持不变。 修改完成后，按“Esc”，输入:wq保存并退出。 执行以下命令，启动增强高速网络端口组“bond1”。 首先启动增强高速网卡“eth6”和“eth7”设备。 ifup eth6 ifup eth7 ifup bond1 参见上述步骤，完成其他裸金属服务器的配置。 待其他裸金属服务器配置完成后，互相ping对端增强高速网络配置的同网段IP，检查是否可以ping通。 如果需要配置VLAN，则按照以下步骤配置。 根据需要配置的VLAN，配置相应VLAN子接口。假设VLAN为316，执行以下命令，编辑“/etc/sysconfig/network-scripts/ifcfg-bond1.316”。 vi /etc/sysconfig/network-scripts/ifcfg-bond1.316 按以下格式编辑： USERCTL=no ONBOOT=yes NM_CONTROLLED=no BOOTPROTO=static DEVICE=bond1.316 TYPE=Ethernet IPADDR=10.10.0.101 NETMASK=255.255.255.0 VLAN=yes PHYSDEV=bond1 其中， “DEVICE”参数取值修改为新增的bond子接口名称。 “IPADDR”参数取值修改为待给“bond1.316”分配的IP地址（为增强高速网卡VLAN子接口规划的IP地址在没有与VPC网段冲突的情况下可任意规划，需要通过增强高速网卡VLAN子接口通信的裸金属服务器须将增强高速网卡VLAN子接口配置在同一个网段），如“10.10.0.101”。 “NETMASK”参数为给增强高速网卡“bond1.316”配置的IP的子网掩码。 其他参数可保持不变。 修改完成后，按“Esc”，输入:wq保存并退出。 待其他裸金属服务器配置完成后，互相ping对端增强高速网络VLAN子接口的同网段IP，检查是否可以ping通。

前提条件 已绑定弹性公网IP。 已下载对应操作系统所需驱动的安装包。 表1 NVIDIA GPU驱动和CUDA工具包下载 操作系统 需要下载的驱动 下载地址 Ubuntu 16.04、CentOS 7.4 NVIDIA GPU驱动安装包“NVIDIA-Linux-x86_64-375.66.run” https://www.nvidia.com/download/driverResults.aspx/118955/en-us CUDA工具包安装包“cuda_8.0.61_375.26_linux.run” https://developer.nvidia.com/cuda-80-ga2-download-archive

CentOS 7.4安装操作 登录裸金属服务器，执行以下命令，切换至root权限。 su root （可选）如果不存在依赖包gcc、gcc-c++、make和kernel-devel，请执行以下命令进行安装。 yum install gcc yum install gcc-c++ yum install make yum install kernel-devel-`uname -r` （可选）将Nouveau驱动列入黑名单。 如果已经安装并加载了Nouveau的显卡驱动，请执行以下操作将Nouveau驱动列入黑名单以避免冲突。 编辑“/etc/modprobe.d/blacklist.conf”，在文件后面添加blacklist nouveau。 运行以下命令备份与重建initramfs： mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak dracut -v /boot/initramfs-$(uname -r).img $(uname -r) 重启：reboot。 （可选）如果X服务正在运行，请执行systemctl set-default multi-user.target命令并重启裸金属服务器以进入多用户模式。 （可选）安装NVIDIA GPU驱动。 如果选择了特定版本的NVIDIA GPU驱动，而不是捆绑在CUDA工具包中的版本，则需要执行此步骤。 下载NVIDIA GPU驱动安装包NVIDIA-Linux-x86_64-xxx.yy.run（下载链接：https://www.nvidia.com/Download/index.aspx?lang=en），并将该安装包上传至裸金属服务器的“/tmp”目录下。 图1 搜索NVIDIA驱动包（CentOS 7.4） 执行以下命令，安装NVIDIA GPU驱动。 sh ./NVIDIA-Linux-x86_64-xxx.yy.run 执行以下命令，删除安装包。 rm -f NVIDIA-Linux-x86_64-xxx.yy.run 安装CUDA工具包。 下载CUDA Toolkit安装包cuda_a.b.cc_xxx.yy_linux.run（下载链接：https://developer.nvidia.com/cuda-downloads），并将该安装包上传至裸金属服务器的“/tmp”目录下。 执行以下命令，修改安装包的权限。 chmod +x cuda_a.b.cc_xxx.yy_linux.run 执行以下命令，安装CUDA工具包。 ./cuda_a.b.cc_xxx.yy_linux.run --toolkit --samples --silent --override --tmpdir=/tmp/ 执行以下命令，删除安装包。 rm -f cuda_a.b.cc_xxx.yy_linux.run 执行如下三条命令，验证是否安装成功。 cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/ make ./deviceQueryDrv 回显信息中包含“Result = PASS”，表示CUDA工具包和NVIDIA GPU驱动安装成功。

Ubuntu 16.04安装操作 登录裸金属服务器，执行以下命令，切换至root权限。 sudo root （可选）如果不存在依赖包gcc、g++和make，请执行以下命令进行安装。 apt-get install gcc apt-get install g++ apt-get install make （可选）将Nouveau驱动列入黑名单。 如果已经安装并加载了Nouveau的显卡驱动，请执行以下操作将Nouveau驱动列入黑名单以避免冲突。 编辑“/etc/modprobe.d/blacklist.conf”，在文件后面加入以下内容： blacklist nouveau options nouveau modeset=0 执行以下命令备份与重建initramfs： mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak sudo update-initramfs -u 重启：sudo reboot （可选）如果X服务正在运行，请执行systemctl set-default multi-user.target命令并重启裸金属服务器以进入多用户模式。 （可选）安装NVIDIA GPU驱动。 如果选择了特定版本的NVIDIA GPU驱动，而不是捆绑在CUDA工具包中的版本，则需要执行此步骤。 下载NVIDIA GPU驱动安装包NVIDIA-Linux-x86_64-xxx.yy.run（下载链接：https://www.nvidia.com/Download/index.aspx?lang=en），并将该安装包上传至裸金属服务器的“/tmp”目录下。 图2 搜索NVIDIA驱动包（Ubuntu 16.04） 执行以下命令，安装NVIDIA GPU驱动。 sh ./NVIDIA-Linux-x86_64-xxx.yy.run 执行以下命令，删除安装包。 rm -f NVIDIA-Linux-x86_64-xxx.yy.run 安装CUDA工具包。 下载CUDA Toolkit安装包cuda_a.b.cc_xxx.yy_linux.run（下载链接：https://developer.nvidia.com/cuda-downloads），并将该安装包上传至裸金属服务器的“/tmp”目录下。 执行以下命令，修改安装包的权限。 chmod +x cuda_a.b.cc_xxx.yy_linux.run 执行以下命令，安装CUDA工具包。 ./cuda_a.b.cc_xxx.yy_linux.run --toolkit --samples --silent --override --tmpdir=/tmp/ 执行以下命令，删除安装包。 rm -f cuda_a.b.cc_xxx.yy_linux.run 执行如下三条命令，验证是否安装成功。 cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/ make ./deviceQueryDrv 回显信息中包含“Result = PASS”，表示CUDA工具包和NVIDIA GPU驱动安装成功。

CentOS 7.4安装操作 登录裸金属服务器，执行以下命令，切换至root权限。 su root （可选）如果不存在依赖包gcc、gcc-c++、make和kernel-devel，请执行以下命令进行安装。 yum install gcc yum install gcc-c++ yum install make yum install kernel-devel-`uname -r` （可选）将Nouveau驱动列入黑名单。 如果已经安装并加载了Nouveau的显卡驱动，请执行以下操作将Nouveau驱动列入黑名单以避免冲突。 编辑“/etc/modprobe.d/blacklist.conf”，在文件后面添加blacklist nouveau。 运行以下命令备份与重建initramfs： mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak dracut -v /boot/initramfs-$(uname -r).img $(uname -r) 重启：reboot。 （可选）如果X服务正在运行，请执行systemctl set-default multi-user.target命令并重启裸金属服务器以进入多用户模式。 （可选）安装NVIDIA GPU驱动。 如果选择了特定版本的NVIDIA GPU驱动，而不是捆绑在CUDA工具包中的版本，则需要执行此步骤。 下载NVIDIA GPU驱动安装包NVIDIA-Linux-x86_64-xxx.yy.run（下载链接：https://www.nvidia.com/Download/index.aspx?lang=en），并将该安装包上传至裸金属服务器的“/tmp”目录下。 图1 搜索NVIDIA驱动包（CentOS 7.4） 执行以下命令，安装NVIDIA GPU驱动。 sh ./NVIDIA-Linux-x86_64-xxx.yy.run 执行以下命令，删除安装包。 rm -f NVIDIA-Linux-x86_64-xxx.yy.run 安装CUDA工具包。 下载CUDA Toolkit安装包cuda_a.b.cc_xxx.yy_linux.run（下载链接：https://developer.nvidia.com/cuda-downloads），并将该安装包上传至裸金属服务器的“/tmp”目录下。 执行以下命令，修改安装包的权限。 chmod +x cuda_a.b.cc_xxx.yy_linux.run 执行以下命令，安装CUDA工具包。 ./cuda_a.b.cc_xxx.yy_linux.run --toolkit --samples --silent --override --tmpdir=/tmp/ 执行以下命令，删除安装包。 rm -f cuda_a.b.cc_xxx.yy_linux.run 执行如下三条命令，验证是否安装成功。 cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/ make ./deviceQueryDrv 回显信息中包含“Result = PASS”，表示CUDA工具包和NVIDIA GPU驱动安装成功。

Ubuntu 16.04安装操作 登录裸金属服务器，执行以下命令，切换至root权限。 sudo root （可选）如果不存在依赖包gcc、g++和make，请执行以下命令进行安装。 apt-get install gcc apt-get install g++ apt-get install make （可选）将Nouveau驱动列入黑名单。 如果已经安装并加载了Nouveau的显卡驱动，请执行以下操作将Nouveau驱动列入黑名单以避免冲突。 编辑“/etc/modprobe.d/blacklist.conf”，在文件后面加入以下内容： blacklist nouveau options nouveau modeset=0 执行以下命令备份与重建initramfs： mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).img.bak sudo update-initramfs -u 重启：sudo reboot （可选）如果X服务正在运行，请执行systemctl set-default multi-user.target命令并重启裸金属服务器以进入多用户模式。 （可选）安装NVIDIA GPU驱动。 如果选择了特定版本的NVIDIA GPU驱动，而不是捆绑在CUDA工具包中的版本，则需要执行此步骤。 下载NVIDIA GPU驱动安装包NVIDIA-Linux-x86_64-xxx.yy.run（下载链接：https://www.nvidia.com/Download/index.aspx?lang=en），并将该安装包上传至裸金属服务器的“/tmp”目录下。 图2 搜索NVIDIA驱动包 执行以下命令，安装NVIDIA GPU驱动。 sh ./NVIDIA-Linux-x86_64-xxx.yy.run 执行以下命令，删除安装包。 rm -f NVIDIA-Linux-x86_64-xxx.yy.run 安装CUDA工具包。 下载CUDA Toolkit安装包cuda_a.b.cc_xxx.yy_linux.run（下载链接：https://developer.nvidia.com/cuda-downloads），并将该安装包上传至裸金属服务器的“/tmp”目录下。 执行以下命令，修改安装包的权限。 chmod +x cuda_a.b.cc_xxx.yy_linux.run 执行以下命令，安装CUDA工具包。 ./cuda_a.b.cc_xxx.yy_linux.run --toolkit --samples --silent --override --tmpdir=/tmp/ 执行以下命令，删除安装包。 rm -f cuda_a.b.cc_xxx.yy_linux.run 执行如下三条命令，验证是否安装成功。 cd /usr/local/cuda/samples/1_Utilities/deviceQueryDrv/ make ./deviceQueryDrv 回显信息中包含“Result = PASS”，表示CUDA工具包和NVIDIA GPU驱动安装成功。 执行以下命令，验证驱动是否正常使用。 nvidia-smi topo -m 回显信息中如果正常显示GPU的信息，则表示驱动可正常使用。

前提条件 已绑定弹性公网IP。 已下载对应操作系统所需驱动的安装包。 表1 NVIDIA GPU驱动和CUDA工具包下载 操作系统 需要下载的驱动 下载地址 Ubuntu 16.04、CentOS 7.4 NVIDIA GPU驱动安装包“NVIDIA-Linux-x86_64-384.81.run” http://www.nvidia.com/download/driverResults.aspx/124722/en-us CUDA工具包安装包“cuda_9.0.176_384.81_linux.run” https://developer.nvidia.com/cuda-90-download-archive?target_os=Linux&target_arch=x86_64&target_distro=CentOS&target_version=7&target_type=runfilelocal

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

URI GET /cloudartifact/v5/{tenant_id}/{project_id}/{module}/{repo}/audit 表1 路径参数 参数 是否必选 参数类型 描述 tenant_id 是 String 租户id project_id 是 String 项目id module 是 String 模块 repo 是 String 仓库id 表2 Query参数 参数 是否必选 参数类型 描述 user_id 否 String 用户id instance_id 否 String 实例id page_num 否 Integer 页码 page_size 否 Integer 每页大小

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表4 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 repository_name 否 String 仓库名称 format 否 String 仓库类型 description 否 String 仓库描述 release 否 String release仓库名称 snapshot 否 String snapshot仓库名称 includes_pattern 否 String 路径 share_right 否 String 共享权限级别 project_id 否 String 项目ID type 否 String 仓库类别，本地仓或聚合仓

响应参数 状态码： 200 表1 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

URI GET /cloudartifact/v5/search/checksum 表1 Query参数 参数 是否必选 参数类型 描述 checksum 是 String checksum page_no 否 Integer 页码 page_size 否 Integer 每页条数 format 否 String 仓库类型 in_project 否 String 是否在项目中 project_id 否 String 项目id

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

API概览 表1 制品仓库接口说明 分类 接口 获取项目下文件版本信息列表 获取项目下文件版本信息列表 回收站 批量还原回收站、批量删除回收站 仓库管理 创建maven仓库、编辑仓库、查看仓库信息、创建docker仓库、删除仓库到回收站、查询租户Maven仓库列表和账号密码、创建非maven仓库、编辑非maven仓库信息 仓库关联项目 查询项目管理关联仓库、创建项目关联仓库 仓库容量 仓库用量查询 搜索 通过checksum搜索文件、统筹搜索 用户管理 重置用户密码 仓库详情 查询仓库详情，不会去统计仓库下的制品数量、查询单个仓库详细信息，会去统计仓库下的制品数量、查询存储容量趋势 审计日志 查询仓库或文件的审计日志信息 关注 关注组件/取消关注组件、查询关注列表 文件管理 查询仓库文件夹目录、查询仓库文件详情、非maven删除文件、

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

URI GET /cloudartifact/v5/maven/info 表1 Query参数 参数 是否必选 参数类型 描述 project_id 否 String 项目id policy 否 String snapshot or releases access 否 String r or rw default 否 String 是否返回默认仓库 true or false ids 否 String 仓库id 多个仓库id用英文逗号间隔

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，制品仓库的终端节点如下表所示，请您根据业务需要选择对应区域的终端节点。 表1 制品仓库的终端节点 区域名称 区域 终端节点（Endpoint） 华东-上海一 cn-east-3 cloudartifacts-ext.cn-east-3.myhuaweicloud.com 华南-广州 cn-south-1 artifact.cn-south-1.myhuaweicloud.com 父主题： 使用前必读

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表4 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

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

请求示例 创建非maven仓库 /v5/artifact/ { "format" : "string", "type" : "string", "repository_name" : "string", "description" : "string", "includes_pattern" : "string", "project_id" : "string", "share_right" : "string" }

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

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id result String 请求返回结果，接口不同，返回不同 状态码： 401 表3 响应Body参数 参数 参数类型 描述 status String 结果状态 trace_id String 请求id error_code String 错误代码 error_msg String 错误信息

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