SDK列表 在开始使用之前，请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以在 SDK中心 查询版本信息。 表1提供了IMS服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 NodeJs huaweicloud-sdk-nodejs-v3 NodeJs SDK使用指导 .NET huaweicloud-sdk-net-v3 .Net SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导 C++ huaweicloud-sdk-cpp-v3 C++ SDK使用指导

附2：执行qemu-img-hw常见报错 问题描述： 执行qemu-img-hw命令时回显信息如下： ./qemu-img-hw: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by ./qemu-img-hw) 解决方法： 执行strings /lib64/libc.so.6 | grep GLIBC查看GLIBC版本，若由于版本过低造成，可安装高版本即可。依次执行下述命令： wget http://ftp.gnu.org/gnu/glibc/glibc-2.15.tar.gz wget http://ftp.gnu.org/gnu/glibc/glibc-ports-2.15.tar.gz tar -xvf glibc-2.15.tar.gz tar -xvf glibc-ports-2.15.tar.gz mv glibc-ports-2.15 glibc-2.15/ports mkdir glibc-build-2.15 cd glibc-build-2.15 ../glibc-2.15/configure --prefix=/usr --disable-profile --enable-add-ons --with-headers=/usr/include --with-binutils=/usr/bin 此命令若报错“configure: error: no acceptable C compiler found in $PATH”，请先执行：yum -y install gcc make make install 问题描述： 执行qemu-img-hw命令时回显信息如下： ./qemu-img-hw: error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory 解决方法：请先执行命令yum install libaio

操作步骤 上传待转换格式的镜像文件至云服务器。 本地主机为Linux系统： 通过scp命令将镜像文件上传至云服务器。以将“image01.qcow2”文件上传至云服务器的“/usr/”目录下为例。 scp /var/image01.qcow2 root@xxx.xxx.xx.xxx:/usr/ 其中，xxx.xxx.xx.xxx为云服务器的弹性公网IP。 本地主机为Windows系统： 使用文件传输工具（例如WinSCP）将镜像文件上传至云服务器。 获取qemu-img-hw工具并上传至云服务器，然后解压工具包。 表2 qemu-img-hw工具获取方式 工具包 下载地址 qemu-img-hw.zip https://cn-south-1-cloud-reset-pwd.obs.cn-south-1.myhuaweicloud.com/imageImportTools/qemu-img-hw.zip 当前工具仅限在x86架构的服务器下使用。 转换镜像格式。 进入qemu-img-hw存放目录，以存放在“/usr/qemu-img-hw”为例： cd /usr/qemu-img-hw 执行以下命令修改权限： chmod +x qemu-img-hw 执行qemu-img-hw命令将镜像文件转为zvhd2格式。 qemu-img-hw命令格式： ./qemu-img-hw convert -p -O {目标镜像格式} {待转换镜像文件} {目标镜像文件} 以将“image01.qcow2”格式文件转换成“image01.zvhd2”格式为例： ./qemu-img-hw convert -p -O zvhd2 image01.qcow2 image01.zvhd2

附1：qemu-img-hw常用命令 镜像文件格式转换：qemu-img-hw convert -p -O {目标镜像格式} {待转换镜像文件} {目标镜像文件} 上述命令中各参数对应的说明如下： -p：标识转换的进度条 -O：（必须是大写）后面的参数为转换出来的镜像格式 + 源镜像文件名称 + 目标镜像文件名称 示例：将qcow2格式转为zvhd2格式 qemu-img-hw convert -p -O zvhd2 test.qcow2 test.zvhd2 查询镜像文件信息：qemu-img-hw info {镜像文件} 示例：qemu-img-hw info test.zvhd2 查看帮助：qemu-img-hw -help

IMS权限 默认情况下，管理员创建的 IAM 用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 IMS部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华北-北京1）对应的项目（cn-north-1）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域下的项目中都生效。访问IMS时，需要先切换至授权区域。 根据授权精度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 表1 IMS系统角色 系统角色 描述 依赖关系 IMS Administrator 镜像服务 的管理员权限。 该角色有依赖，需要勾选依赖的角色：Tenant Administrator。 Server Administrator 拥有该权限的用户可以创建、删除、查询、修改及上传镜像。 该角色有依赖，需要在同项目中勾选依赖的角色：IMS Administrator。 策略（推荐）：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对IMS服务，管理员能够控制IAM用户仅能对某一类镜像资源进行指定的管理操作。 多数策略以API接口为粒度进行权限拆分，IMS支持的API授权项请参见：权限及授权项说明。 表2 IMS系统策略 策略名称 描述 依赖关系 IMS FullAccess 镜像服务所有权限。 无 IMS ReadOnlyAccess 镜像服务只读权限，拥有该权限的用户仅能查看镜像服务数据。 无 表3列出了镜像服务（IMS）常用操作与系统权限的授权关系，您可以参照该表选择合适的系统权限。 表3 常用操作与系统权限的关系 操作 IMS FullAccess IMS ReadOnlyAccess IMS Administrator（需依赖Tenant Administrator） 创建镜像 √ x √ 删除镜像 √ x √ 查询镜像 √ √ √ 更新镜像信息 √ x √

鲲鹏系统架构云服务器系列 以下云服务器支持的操作系统请参考表7。 鲲鹏通用计算增强型：kc1 鲲鹏内存优化型：km1 鲲鹏超高I/O型云服务器：ki1系列支持CentOS 7.6、Huawei Cloud EulerOS 2.0。 鲲鹏AI推理加速型云服务器：kAi1s系列仅支持CentOS 7.6、Ubuntu 18.04 Server。 表7 OS-支持版本 OS发行版本 支持版本 Huawei Cloud EulerOS Huawei Cloud EulerOS 2.0 标准版 Huawei Cloud EulerOS 2.0 等保2.0三级版 CentOS 64bit：CentOS 8：8.0 64bit：CentOS 7：7.6/7.5/7.4 Ubuntu 64bit：Ubuntu 18.04 Server EulerOS 64bit：EulerOS 2.8 Red Hat 64bit：Red Hat 7：7.6/7.5 SUSE Linux Enterprise 64bit：SLES 12 SP5/SP4 64bit：SLES 15 openSUSE 64bit：openSUSE Leap 15：15.0 Fedora 64bit：Fedora 29 Debian 64bit：Debian 10.2.0 openEuler 64bit：openEuler 20.03 KylinSec 麒麟信安 64bit：KylinSec 3.3 Kylin 银河麒麟 64bit：KylinOS_V10_SP3 64bit：KylinOS_V10_SP2 64bit：KylinOS_V10_SP1 UnionTechOS 统信 64 bit：UnionTechOS Server 20 1050e NeoKylin 中标麒麟 64bit：NeoKylin 7.6 Rocky Linux 64bit：Rocky Linux 8.7

x86系统架构云服务器系列 以下云服务器支持的操作系统请参考表 OS-支持版本。 通用入门型：t6 通用计算型：s2、s3、s6、sn3、s7 通用计算增强型：c3、c6、c6s、c6h、c7 内存优化型：m2、m3、m6、m7 高性能计算型：hc2、h3 磁盘增强型：d2、d3、d6 以下云服务器支持的操作系统请参考表2。 通用计算增强型：c3ne 内存优化型：m3ne 以下云服务器支持的操作系统请参考表3。 超大内存型：e3、e6、e7 以下云服务器支持的操作系统请参考表4。 超高I/O型：i3、ir3 以下云服务器支持的操作系统请参考表5。 超高I/O型：i7、ir7 i7系列仅支持CentOS 7.4、CentOS 8.1。 以下云服务器支持的操作系统请参考表6。 通用计算增强型：ac7、ac8 其他GPU加速型实例参考GPU产品说明。 建议您使用操作系统官方发行版本进行系统构建，避免对发行版本进行裁剪及高度定制，以减少问题发生概率。 操作系统发行版本由操作系统厂商进行不定期版本更迭，部分系统版本厂商已停止维护，不再发布问题修复及安全补丁，建议及时关注厂商公告进行系统升级更新，保证您系统的健壮性。 表1 OS-支持版本 OS发行系列 支持版本 Windows Windows Server 2022 Standard/Datacenter Windows Server 2019 Standard/Datacenter Windows Server 2016 Standard/Datacenter Windows Server 2012 R2 Standard/Datacenter Windows Server 2012 Standard/Datacenter Windows Server 2008 R2 Standard/Enterprise/Datacenter/Web Windows Server Core Version 1709 Huawei Cloud EulerOS 64bit：Huawei Cloud EulerOS 2.0 标准版 64bit：Huawei Cloud EulerOS 2.0 等保2.0三级版 64bit：Huawei Cloud EulerOS 1.1 CentOS兼容版 说明： 仅s7/s6/c7/c6s/c6/m7/m6/d6系列云服务器支持Huawei Cloud EulerOS 2.0各版本的操作系统。 仅s6/c6s/c6/m6/d6系列云服务器支持Huawei Cloud EulerOS 1.1 CentOS兼容版操作系统。 Huawei Cloud EulerOS 1.1 CentOS兼容版仅支持新加坡区域。 CentOS 64bit：CentOS 8：8.3/8.2/8.1/8.0 64bit：CentOS 7：7.9/7.8/7.7/7.6/7.5/7.4/7.3/7.2/7.1/7.0 64bit：CentOS 6：6.10/6.9/6.8/6.7/6.6/6.5/6.4/6.3 CentOS Stream 64bit：CentOS Stream 9 64bit：CentOS Stream 8 Ubuntu 64bit：Ubuntu 22.04/20.04/18.04/16.04/14.04/12.04 Server EulerOS 64bit：EulerOS 2.5/2.3/2.2 Red Hat 64bit：Red Hat 8：8.0 64bit：Red Hat 7：7.9/7.8/7.6/7.5/7.4/7.3/7.2/7.1/7.0 64bit：Red Hat 6：6.10/6.9/6.8/6.7/6.6/6.5/6.4 SUSE Linux Enterprise 64bit：SLES 15：15/15 SP1/15 SP2/15 SP3 64bit：SLES 12：12 SP4/12 SP3/12 SP2/12 SP1/12 64bit：SLES 11：11 SP4/11 SP3 Debian 64bit：Debian 11：11.1.0 64bit：Debian 10：10.0.0~10.5.0、10.7.0 64bit：Debian 9：9.13.0/9.12.0/9.11.0/9.9.0/9.8.0/9.7.0/9.6.0/9.5.0/9.4.0/9.3.0/9.0.0 64bit：Debian 8：8.0.0~8.10.0 openSUSE 64bit：openSUSE Leap 42：42.3/42.2/42.1 64bit：openSUSE Leap 15：15.1/15.0 64bit：openSUSE 13：13.2 Fedora 64bit：Fedora 22~32 CoreOS 64bit：CoreOS 2079.4.0 FreeBSD 64bit：FreeBSD 12.1、FreeBSD 11.0、FreeBSD 10.3 openEuler 64bit：openEuler 22.03 64bit：openEuler 20.03 AlmaLinux 64bit：AlmaLinux 9.0 64bit：AlmaLinux 8.4 64bit：AlmaLinux 8.3 Rocky Linux 64bit：Rocky Linux 9.0 64bit：Rocky Linux 8.5 64bit：Rocky Linux 8.4 表2 OS-支持版本 OS发行版本 支持版本 Windows Windows Server 2019 Datacenter Windows Server 2016 Standard/Datacenter Windows Server 2012 R2 Standard/Datacenter Windows Server 2008 R2 Enterprise/Datacenter/Web/Standard Windows Server Version 1709 Datacenter CentOS 64bit： CentOS 8 CentOS 7 CentOS 6 Ubuntu 64bit： Ubuntu 22.04 Server Ubuntu 20.04 Server Ubuntu 18.04 Server Ubuntu 16.04 Server Ubuntu 14.04 Server EulerOS 64bit： EulerOS 2.5 EulerOS 2.3 EulerOS 2.2 Red Hat 64bit： Red Hat 7 Red Hat 6 SUSE Linux Enterprise 64bit： SLES 12 SLES 11 Debian 64bit： Debian 9 Debian 8 openSUSE 64bit： openSUSE 15.1 openSUSE 15.0 Fedora 64bit： Fedora 2x openEuler 64bit： openEuler 20.03 表3 OS-支持版本 OS发行版本 支持版本 Huawei Cloud EulerOS 说明： 仅e6系列云服务器支持此操作系统。 Huawei Cloud EulerOS 2.0 标准版 Huawei Cloud EulerOS 2.0 等保2.0三级版 CentOS 64bit： CentOS 8 CentOS 7 CentOS 6 Ubuntu 64bit： Ubuntu 20.04 Server Ubuntu 18.04 Server Ubuntu 16.04 Server Ubuntu 14.04 Server EulerOS 64bit： EulerOS 2.5 EulerOS 2.3 EulerOS 2.2 Red Hat 64bit： Red Hat 7 Red Hat 6 SUSE Linux Enterprise 64bit： SLES 15 SLES 12 SLES 11 Debian 64bit： Debian 10 Debian 9 Debian 8 openSUSE 64bit： openSUSE 15.1 openSUSE 15.0 Fedora 64bit： Fedora 3x Fedora 2x openEuler 64bit： openEuler 20.03 表4 OS-支持版本 OS发行版本 支持版本 CentOS 64bit： CentOS 7 Ubuntu 64bit： Ubuntu 20.04 Server Ubuntu 18.04 Server Ubuntu 16.04 Server Ubuntu 14.04 Server EulerOS 64bit： EulerOS 2.3 EulerOS 2.2 SUSE Linux Enterprise 64bit： SLES 12 Debian 说明： ir3系列云服务器不支持Debian操作系统。 64bit： Debian 9 Debian 8

相关操作 如果您本地的镜像文件不符合格式要求，可以借助工具对镜像格式进行转换，请参见“通过qemu-img工具转换镜像格式”或“通过qemu-img-hw工具转换镜像格式”。 如何上传外部镜像文件，请参见“上传镜像文件（Windows）”和“上传镜像文件（Linux）”。 外部镜像文件上传成功后，您可以通过注册镜像，将外部镜像文件注册为云平台的私有镜像。具体操作，请参见“注册镜像（Windows）”和“注册镜像（Linux）”。

支持的操作系统类型 外部镜像文件支持的操作系统类型包含： x86架构类型 ARM架构类型 在管理控制台上传外部镜像文件时，系统会自动对镜像的操作系统进行识别。外部镜像文件支持的操作系统类型如表1和表2所示。 如果待注册的操作系统版本无法识别或不包含在支持列表中： 对于Windows操作系统，在注册镜像过程中系统会按照“Other_Windows (64_bit)”或“Other_Windows (32_bit)”类型进行处理。 对于Linux操作系统，在注册镜像过程中系统会按照“Other_Linux (64_bit)”或“Other_Linux (32_bit)”类型进行处理。 未包含在表1和表2中的操作系统类型有可能不支持镜像上传功能，建议咨询客户服务确认。 裸金属服务器镜像支持的镜像格式和操作系统类型请参考《裸金属服务器私有镜像制作指南》。 表1 外部镜像文件支持的操作系统类型（x86架构类型） 操作系统类型 操作系统版本 Rocky Linux Rocky Linux 9.0 64bit Rocky Linux 8.5 64bit Rocky Linux 8.4 64bit Rocky Linux 8.3 64bit AlmaLinux AlmaLinux 9.0 64bit AlmaLinux 8.4 64bit AlmaLinux 8.3 64bit Windows Windows 10 64bit Windows Server 2022 Standard 64bit Windows Server 2022 Datacenter 64bit Windows Server 2019 Standard 64bit Windows Server 2019 Datacenter 64bit Windows Server 2016 Standard 64bit Windows Server 2016 Datacenter 64bit Windows Server 2012 R2 Standard 64bit Windows Server 2012 R2 Essentials 64bit Windows Server 2012 R2 Datacenter 64bit Windows Server 2012 Datacenter 64bit Windows Server 2012 Standard 64bit Windows Server 2008 WEB R2 64bit Windows Server 2008 R2 Standard 64bit Windows Server 2008 R2 Enterprise 64bit Windows Server 2008 R2 Datacenter 64bit SUSE SUSE Linux Enterprise Server 15 SP5 64bit SUSE Linux Enterprise Server 15 SP4 64bit SUSE Linux Enterprise Server 15 SP3 64bit SUSE Linux Enterprise Server 15 SP2 64bit SUSE Linux Enterprise Server 15 SP1 64bit SUSE Linux Enterprise Server 15 64bit SUSE Linux Enterprise Server 12 SP5 64bit SUSE Linux Enterprise Server 12 SP4 64bit SUSE Linux Enterprise Server 12 SP3 64bit SUSE Linux Enterprise Server 12 SP2 64bit SUSE Linux Enterprise Server 12 SP1 64bit SUSE Linux Enterprise Server 11 SP4 64bit SUSE Linux Enterprise Server 11 SP3 64bit SUSE Linux Enterprise Server 11 SP3 32bit Oracle Linux Oracle Linux Server release 7.6 64bit Oracle Linux Server release 7.5 64bit Oracle Linux Server release 7.4 64bit Oracle Linux Server release 7.3 64bit Oracle Linux Server release 7.2 64bit Oracle Linux Server release 7.1 64bit Oracle Linux Server release 7.0 64bit Oracle Linux Server release 6.10 64bit Oracle Linux Server release 6.9 64bit Oracle Linux Server release 6.8 64bit Oracle Linux Server release 6.7 64bit Oracle Linux Server release 6.5 64bit Red Hat Red Hat Linux Enterprise 8.0 64bit Red Hat Linux Enterprise 7.9 64bit Red Hat Linux Enterprise 7.8 64bit Red Hat Linux Enterprise 7.6 64bit Red Hat Linux Enterprise 7.5 64bit Red Hat Linux Enterprise 7.4 64bit Red Hat Linux Enterprise 7.3 64bit Red Hat Linux Enterprise 7.2 64bit Red Hat Linux Enterprise 7.1 64bit Red Hat Linux Enterprise 7.0 64bit Red Hat Linux Enterprise 6.10 64bit Red Hat Linux Enterprise 6.9 64bit Red Hat Linux Enterprise 6.8 64bit Red Hat Linux Enterprise 6.7 64bit Red Hat Linux Enterprise 6.6 64bit Red Hat Linux Enterprise 6.6 32bit Red Hat Linux Enterprise 6.5 64bit Red Hat Linux Enterprise 6.4 64bit Red Hat Linux Enterprise 6.4 32bit Ubuntu Ubuntu 22.04 Server 64bit Ubuntu 20.04 Server 64bit Ubuntu 19.04 Server 64bit Ubuntu 18.04.2 Server 64bit Ubuntu 18.04.1 Server 64bit Ubuntu 18.04 Server 64bit Ubuntu 16.04.6 Server 64bit Ubuntu 16.04.5 Server 64bit Ubuntu 16.04.4 Server 64bit Ubuntu 16.04.3 Server 64bit Ubuntu 16.04.2 Server 64bit Ubuntu 16.04 Server 64bit Ubuntu 14.04.5 Server 64bit Ubuntu 14.04.4 Server 64bit Ubuntu 14.04.4 Server 32bit Ubuntu 14.04.3 Server 64bit Ubuntu 14.04.3 Server 32bit Ubuntu 14.04.1 Server 64bit Ubuntu 14.04.1 Server 32bit Ubuntu 14.04 Server 64bit Ubuntu 14.04 Server 32bit openSUSE openSUSE 42.3 64bit openSUSE 42.2 64bit openSUSE 42.1 64bit openSUSE 15.5 64bit openSUSE 15.4 64bit openSUSE 15.3 64bit openSUSE 15.1 64bit openSUSE 15.0 64bit openSUSE 13.2 64bit openSUSE 11.3 64bit CentOS CentOS 8.3 64bit CentOS 8.2 64bit CentOS 8.1 64bit CentOS 8.0 64bit CentOS 8.0 64bit CentOS 7.9 64bit CentOS 7.8 64bit CentOS 7.7 64bit CentOS 7.6 64bit CentOS 7.5 64bit CentOS 7.4 64bit CentOS 7.3 64bit CentOS 7.2 64bit CentOS 7.1 64bit CentOS 7.0 64bit CentOS 7.0 32bit CentOS 6.10 64bit CentOS 6.10 32bit CentOS 6.9 64bit CentOS 6.8 64bit CentOS 6.7 64bit CentOS 6.7 32bit CentOS 6.6 64bit CentOS 6.6 32bit CentOS 6.5 64bit CentOS 6.5 32bit CentOS 6.4 64bit CentOS 6.4 32bit CentOS 6.3 64bit CentOS 6.3 32bit Debian Debian GNU/Linux 12.0.0 64bit Debian GNU/Linux 11.1.0 64bit Debian GNU/Linux 10.7.0 64bit Debian GNU/Linux 10.5.0 64bit Debian GNU/Linux 10.4.0 64bit Debian GNU/Linux 10.3.0 64bit Debian GNU/Linux 10.2.0 64bit Debian GNU/Linux 10.1.0 64bit Debian GNU/Linux 10.0.0 64bit Debian GNU/Linux 9.13.0 64bit Debian GNU/Linux 9.3.0 64bit Debian GNU/Linux 9.0.0 64bit Debian GNU/Linux 8.10.0 64bit Debian GNU/Linux 8.8.0 64bit Debian GNU/Linux 8.7.0 64bit Debian GNU/Linux 8.6.0 64bit Debian GNU/Linux 8.5.0 64bit Debian GNU/Linux 8.4.0 64bit Debian GNU/Linux 8.2.0 64bit Debian GNU/Linux 8.1.0 64bit Fedora Fedora 32 64bit Fedora 31 64bit Fedora 30 64bit Fedora 29 64bit Fedora 28 64bit Fedora 27 64bit Fedora 26 64bit Fedora 25 64bit Fedora 24 64bit Fedora 23 64bit Fedora 22 64bit EulerOS EulerOS 2.10 64bit EulerOS 2.9 64bit EulerOS 2.5 64bit EulerOS 2.3 64bit EulerOS 2.2 64bit EulerOS 2.1 64bit CoreOS CoreOS 1800.1.0 CoreOS 1745.2.0 CoreOS 1632.0.0 CoreOS 1520.8.0 CoreOS 1465.8.0 CoreOS 1298.5.0 CoreOS 1122.3.0 CoreOS 1122.2.0 CoreOS 1185.5.0 CoreOS 1068.10.0 CoreOS 1010.5.0 CoreOS 1298.6.0 openEuler openEuler 22.03 64bit openEuler 20.03 64bit 中标麒麟 NeoKylin 7.6 64bit NeoKylin 7.4 64bit NeoKylin Server release 5.0 U2 64bit NeoKylin Linux Advanced Server release 7.0 U5 64bit 表2 外部镜像文件支持的操作系统类型（ARM架构类型） 操作系统类型 操作系统版本 AlmaLinux AlmaLinux 8.4 64bit AlmaLinux 8.3 64bit CentOS CentOS 8.0 64bit CentOS 7.6 64bit CentOS 7.5 64bit CentOS 7.4 64bit Debian Debian GNU/Linux 10.2.0 64bit EulerOS EulerOS 2.10 64bit EulerOS 2.9 64bit EulerOS 2.8 64bit Fedora Fedora 29 64bit Ubuntu Ubuntu 20.04 Server 64bit Ubuntu 19.04 Server 64bit Ubuntu 18.04 Server 64bit SUSE SUSE Linux Enterprise Server 12 SP5 64bit openEuler openEuler 22.03 64bit openEuler 20.03 64bit openSUSE openSUSE 15.0 64bit 中标麒麟 NeoKylin V7 64bit NeoKylin 7.7 64bit 统信 UOS 20 64bit 银河麒麟 Kylin V10 64bit Kylin Desktop V10 64bit 麒麟信安 KylinSec 3.3 64bit 普华 iSoft 5.1 64bit

约束与限制 qemu-img镜像格式转换工具支持vhd、vmdk、qcow2、raw、vhdx、qcow、vdi或qed社区格式的镜像的相互转换。 zvhd和zvhd2是云服务内部自研格式，qemu-img工具无法识别这两种格式的镜像文件。如需将镜像文件转换为这两种格式，请使用自研qemu-img-hw工具，详细指导参见转换镜像格式（qemu-img-hw）。 vhd格式镜像在执行命令转换格式时请使用vpc代替，否则可能造成qemu-img工具无法识别镜像格式。 例如，将CentOS 6.9镜像的vhd格式转换为qcow2格式，请执行如下命令： qemu-img convert -p -f vpc -O qcow2 centos6.9.vhd centos6.9.qcow2

典型应用举例 应用场景 用户从VMware平台导出一个pre-allocated格式的镜像文件（pre-allocated格式是VMDK monolithic Flat子格式类型），pre-allocated格式镜像依赖2个文件“xxxx.vmdk”和“xxxx-flat.vmdk”（“xxxx.vmdk”是一个配置文件，“xxxx-flat.vmdk”是实际数据文件），这两种格式的镜像文件不能直接导入到云平台，需提前转换成通用的vmdk或qcow2格式才能导入。 以下以镜像文件格式为centos6.9-64bit-flat.vmdk和centos6.9-64bit.vmdk为例，通过qemu-img工具转换镜像格式。 操作步骤 执行如下命令，查询镜像文件的详细信息。 ls -lh centos6.9-64bit* qemu-img info centos6.9-64bit.vmdk qemu-img info centos6.9-64bit-flat.vmdk 回显信息如下所示： [root@CentOS7 tmp]# ls -lh centos6.9-64bit* -rw-r--r--. 1 root root 10G Jun 13 05:30 centos6.9-64bit-flat.vmdk -rw-r--r--. 1 root root 327 Jun 13 05:30 centos6.9-64bit.vmdk [root@CentOS7 tmp]# qemu-img info centos6.9-64bit.vmdk image: centos6.9-64bit.vmdk file format: vmdk virtual size: 10G (10737418240 bytes) disk size: 4.0K Format specific information: cid: 3302005459 parent cid: 4294967295 create type: monolithicFlat extents: [0]: virtual size: 10737418240 filename: centos6.9-64bit-flat.vmdk format: FLAT [root@CentOS7 tmp]# qemu-img info centos6.9-64bit-flat.vmdk image: centos6.9-64bit-flat.vmdk file format: raw virtual size: 10G (10737418240 bytes) disk size: 0 从回显信息中看出，centos6.9-64bit.vmdk文件的格式为vmdk，centos6.9-64bit-flat.vmdk文件的格式为raw，在执行镜像格式转换命令时，源镜像文件必须使用centos6.9-64bit.vmdk（详见步骤3）。 执行如下命令，查看pre-allocated格式的镜像文件的相关配置信息。 cat centos6.9-64bit.vmdk 回显信息如下所示： [root@CentOS7 tmp]# cat centos6.9-64bit.vmdk # Disk DescriptorFile version=1 CID=c4d09ad3 parentCID=ffffffff createType="monolithicFlat" # Extent description RW 20971520 FLAT "centos6.9-64bit-flat.vmdk" 0 # The Disk Data Base #DDB ddb.virtualHWVersion = "4" ddb.geometry.cylinders = "20805" ddb.geometry.heads = "16" ddb.geometry.sectors = "63" ddb.adapterType = "ide" 将centos6.9-64bit-flat.vmdk和centos6.9-64bit.vmdk放在同一个目录下，执行如下命令，通过qemu-img工具转换镜像格式为qcow2。 [root@CentOS7 tmp]# qemu-img convert -p -f vmdk -O qcow2 centos6.9-64bit.vmdk centos6.9-64bit.qcow2 (100.00/100%) 执行如下命令，查询转换后的qcow2格式镜像文件的详细信息。 qemu-img info centos6.9-64bit.qcow2 回显信息如下所示： [root@CentOS7 tmp]# qemu-img info centos6.9-64bit.qcow2 image: centos6.9-64bit.qcow2 file format: qcow2 virtual size: 10G (10737418240 bytes) disk size: 200K cluster_size: 65536 Format specific information: compat: 1.1 lazy refcounts: false

本地为Linux操作系统 操作过程中如果出现报错，可参考附2：执行qemu-img-hw常见报错。 安装qemu-img。 Ubuntu、Debian系列操作系统，请执行如下命令： apt install qemu-img CentOS、Red Hat、Oracle系列操作系统，请执行如下命令： yum install qemu-img SUSE、openSUSE系列操作系统，请执行如下命令： zypper install qemu-img 执行如下命令，验证安装成功。 qemu-img -v 如回显信息中出现qemu-img工具的版本信息和帮助手册，即表示安装成功。以CentOS 7为例，回显信息如下所示： [root@CentOS7 ~]# qemu-img -v qemu-img version 1.5.3, Copyright (c) 2004-2008 Fabrice Bellard usage: qemu-img command [command options] QEMU disk image utility Command syntax: check [-q] [-f fmt] [--output=ofmt] [-r [leaks | all]] [-T src_cache] filename create [-q] [-f fmt] [-o options] filename [size] commit [-q] [-f fmt] [-t cache] filename compare [-f fmt] [-F fmt] [-T src_cach] 转换镜像格式，以CentOS 7操作系统中转换vmdk格式为qcow2格式的镜像为例。 执行如下命令转换镜像文件格式。 qemu-img convert -p -f vmdk -O qcow2 centos6.9.vmdk centos6.9.qcow2 上述命令中各参数对应的说明如下： -p标识转换的进度条。 -f后面为源镜像格式。 -O（必须是大写）后面的参数为转换出来的镜像格式 + 源镜像文件名称 + 目标文件名称。 转换完成后，目标文件会出现在源镜像文件所在的目录下。 回显信息如下所示： [root@CentOS7 home]# qemu-img convert -p -f vmdk -O qcow2 centos6.9.vmdk centos6.9.qcow2 (100.00/100%) 执行如下命令，查询转换后的qcow2格式镜像文件的详细信息。 qemu-img info centos6.9.qcow2 回显信息如下所示： [root@CentOS7 home]# qemu-img info centos6.9.qcow2 image: centos6.9.qcow2 file format: qcow2 virtual size: 1.0G (1073741824 bytes) disk size: 200K cluster_size: 65536 Format specific information: compat: 1.1 lazy refcounts: false

约束与限制 支持系统盘镜像和数据盘镜像跨区域复制的区域，请见下图或参见支持跨区域复制系统盘镜像和数据盘镜像的区域有哪些？ 图2 支持跨区域复制镜像的区域 “√”表示支持跨区域复制镜像。 “×”表示不支持跨区域复制镜像，可手动在A区域做镜像导出，再将其导入到B区域。 “-”表示相同区域不涉及跨区域复制镜像。 部分区域变更调整会影响镜像的跨区域复制范围，实际支持的跨区域复制范围，请以控制台界面为准。已注册的老用户跨区域复制不受影响。 图中未包含的区域，不支持跨区域复制系统盘镜像和数据盘镜像。 对于整机镜像，各区域支持的跨区域复制范围存在差异，以控制台界面为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。 跨区域复制镜像仅适用于私有镜像。如果您需要复制其他类型的镜像（如公共镜像），可先使用镜像创建云服务器，再使用该云服务器创建私有镜像，然后复制该私有镜像。 私有镜像发布为市场镜像后，不支持跨区域复制。 由市场镜像创建的云服务器所生成的私有镜像（如windows镜像），不支持跨区域复制镜像。 IAM用户如需使用跨区域复制功能，必须具备IAM ReadOnlyAccess权限，并同时具备源区域和目的区域的IMS FullAccess权限。 跨区域复制镜像的大小限制如下： “华南-广州”、“华东-上海一”、“华东-上海二”和“华北-北京四”用于跨区域复制的镜像不能超过300GB；其他区域用于跨区域复制的镜像不能超过128GB。 每个用户只能同时跨区域复制5个镜像。 暂不支持跨区域复制ISO镜像、加密镜像。

附：创建IAM委托 登录管理控制台。 单击右上方登录的用户名，在下拉列表中选择“ 统一身份认证 ”。 在左侧导航栏中，单击“委托”。 在“委托”页面，单击“创建委托”。 在“创建委托”页面，设置如下参数： 委托名称：按需填写，例如“ims_admin_agency”。 图5 创建委托 委托类型：选择“云服务”。 云服务：（“委托类型”选择“云服务”时出现此参数项。）在下拉列表中选择“镜像服务IMS"。 持续时间：选择“永久”。 描述：非必选，可以填写“拥有IMS Administrator权限的委托”。 单击“下一步”，进入给委托授权页面。 在以下作用范围：选择 “区域级项目”，并在下拉表中选择被授权区域或区域下的子项目。 “跨区域复制镜像”场景的委托必须具备“目的镜像区域”的IMS Administrator权限。例如：用户想从“华北-北京四” 复制到“华东-上海一”，则添加的委托必须具备“华东-上海一”的IMS Administrator权限。 选择时，请勿选择“所有项目”，否则委托将不生效。 拥有以下权限：勾选“IMS Administrator”前的复选框。 图6 给委托授权 单击“确定”，完成委托的创建。 图7 新创建的委托 图8 新创建委托的权限

操作场景 镜像是一种区域性资源，私有镜像归属于其被创建时的区域，如果需要在其他区域使用某一私有镜像，可以通过跨区域复制镜像功能实现。 跨区域复制镜像的典型场景为系统环境多区域部署，以应对系统高可用及国际化的趋势。部署方式通常需要多区域+海外节点部署，快速实现跨区域复制云服务器的方法之一便是通过复制镜像将一个镜像复制到多个区域，然后使用私有镜像快速部署云服务器。如图1所示。 图1 跨区域复制典型场景示意图