Image Import Restrictions
Updated at：2025-10-20
Linux system image type restrictions
| Type of restriction | Introduction |
|---|---|
| OS | Support images of CentOS, Ubuntu, Debian, OpenSUSE and SUSE distribution versions |
| Image format | Support qcow2, raw, vmdk and vhd formats |
| Image size | Image vsize does not exceed 500G |
| Network | Dynamically retrieve network addresses; IPV6 is not currently supported; multiple network interface cards are not supported |
| Driver | The image must be installed with the virtio driver for the virtualization platform (KVM). Please refer to Check the Virtio Driver of Linux System |
| cloud-init | It is recommended to install cloudinit for the image. Please refer to Install a cloud-init (Linux) |
| File system | Linux images currently support ext3 and ext4 (ext4 has no metadata_csum feature), and xfs file systems (excluding V5 xfs); do not support LVM disk partition |
| Image file URL | Only BOS URL that is in the same region as the region to be imported into the image can be used |
Other suggestions:
- Do not modify /etc/issue*; otherwise, it will cause the system distribution not to be recognized properly, resulting in system creation problems.
- Do not modify/boot/grub/menu.lst; otherwise, it will cause the system to fail to start.
- Do not modify /etc/shadow to read-only; otherwise, it will cause the inability to modify the password file and sign in to the system.
- Do not enable selinux by modifying /etc/selinux/config; otherwise, it will cause the system to fail to start.
- Do not modify key system files such as /sbin, /bin, /lib *directory.
- Do not adjust the system disk partition. Currently only a single root partition (multiple disk partitions may cause data injection failure) is supported.
- Please check the remaining space on the system disk to ensure that it is not fully written.
- Before importing, please confirm the integrity of the file system.
- Before importing, check the startup parameters of the grub configuration file, which cannot contain the "pcie_aspm=off” parameter; otherwise, it will cause subsequent detaching disk failures. The specific check methods are as follows:
CentOS6 View/boot/grub/grub.conf
CentOS7/8 View/boot/grub2/grub.cfg
As shown in the image, taking CentOS7 as an example, check whether the part displayed in the red box in menuentry contains the "pcie_aspm=off" parameter. If any, manually delete it.
Windows system image type restrictions
| Type of restriction | Introduction |
|---|---|
| OS | Windows Server 2008 R2, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019 and Windows Server 2022 (Data Center Edition) |
| Image format | Support qcow2, raw, vmdk and vhd formats |
| Image size | Image vsize does not exceed 2T |
| Network | Dynamically retrieve network address |
| Driver | The image must be installed with the virtio driver for the virtualization platform (KVM). The Windows system is not installed with the virtio driver by default. Please install the virtio driver before importing the image |
| cloudbase-init | It is recommended to install cloudbase-init for the image. Please refer to Install a cloudbase-init (Windows) |
| File system | Only support NTFS file systems with MBR disk partitions; GPT disk partition is not supported |
| Image file URL | Only BOS URL that is in the same region as the region to be imported into the image can be used |
Other suggestions:
- Before importing a Windows OS image, ensure the file system's integrity has been verified.
- Verify that there is sufficient free space on the system disk to prevent it from filling up completely.
- Avoid making changes to critical system files.