tencent cloud



Last updated: 2022-05-06 10:33:33

    In addition to creating a custom image, you can also import the system disk images of local servers or servers on other cloud platforms to a custom CVM image, and then create or reinstall a CVM with it.


    Prepare an image file that meets the import requirements.

    Image AttributeRequirements
    • CentOS, Ubuntu, Debian, CoreOS, openSUSE, and SUSE
    • Both 32-bit and 64-bit OSs are supported
    Image format
    • RAW, VHD, QCOW2, and VMDK
    • Run qemu-img info imageName | grep 'file format' to check the image format.
    File system typeGPT partition is not supported
    Image size
    • The actual image size cannot exceed 50 GB. Run qemu-img info imageName | grep 'disk size' to check the image size.
    • The image vsize cannot exceed 500 GB. Run qemu-img info imageName | grep 'virtual size' to check the image vsize.
    Note: size of an image in QCOW2 format is used upon check during import.
    • By default, Tencent Cloud provides the eth0 network interface for the instance.
    • You can use the metadata service to query the network configuration of the instance. For more information, see Instance Metadata.
    KernelNative kernel is preferred for an image. Any modifications on the kernel may cause the import to fail.
    RegionImporting images from COS in another region is unavailable for the Shanghai Finance and Shenzhen Finance.


    1. Log in to the CVM console and click Images on the left sidebar.
    2. Select Custom image and click Importing an image.
    3. Activate COS, and then create a bucket. Upload the image file to the bucket and obtain the image file URL as stated in Downloading Objects.
    4. Click Next.
    5. Complete the configurations and click Import.

      Ensure the entered COS file URL is correct.

      You will be notified about the result of import in the Message Center.

    Failed Imports

    If the import failed, troubleshoot as follows:


    Make sure you have subscribed to product service notifications via Message Subscription. This ensures you can receive notifications from Message Center, SMS messages, and emails about the cause of failure.


    If you do not subscribe to product service notifications, you will not receive the import result in Message Center.


    You can refer to the following information for troubleshooting on errors. See error codes for detailed error prompt and error description.

    InvalidUrl: invalid COS URL


    The InvalidUrl error indicates that an incorrect COS URL has been entered. The possible causes are:

    • The image URL you entered is not a Tencent Cloud COS image URL.
    • The COS URL is not allowed for public read and private write.
    • The COS file is allowed for private read, but the signature has expired.

      Signed COS URLs can only be accessed once.

    • A COS URL of another region has been entered.

      The image import service accesses the COS server in the local region through the private network.

    • The user's image file has been deleted.
      If you receive the error message about an invalid COS URL, troubleshoot based on the reasons above.

    InvalidFormatSize: invalid format or size


    The InvalidFormatSize error indicates that the format or size of an image to be imported does not meet the following requirements of Tencent Cloud:

    • Supported image file formats are qcow2,vhd, vmdk, and raw.
    • The size of an image file to be imported cannot exceed 50 GB (based on the size in qcow2 format).
    • The size of the system disk to which the image is imported cannot exceed 500 GB.

    If you receive an error message that the image format or size is invalid:

    VirtioNotInstall: Virtio driver not installed


    The VirtioNotInstall error indicates that the image to be imported does not have Virtio driver installed. Tencent Cloud uses the KVM virtualization technology and requires users to install Virtio driver on the image to be imported. Except for a few customized Linux OSs, most Linux OSs have Virtio driver installed. In Windows OSs, users need to manually install the Virtio driver:

    CloudInitNotInstalled: cloud-init program not installed


    The CloudInitNotInstalled error indicates that the image to be imported does not have cloud-init installed. Tencent Cloud uses the open-source cloud-init software to initialize the CVM. If cloud-init is not installed, the CVM initialization will fail.

    PartitionNotPresent: partition information not found


    The PartitionNotPresent error indicates that the imported image is incomplete. Check whether the boot partition was included when the image was created.

    RootPartitionNotFound: root partition not found


    The RootPartitionNotFound error indicates that the root partition cannot be detected in the image to be imported. Check the image file. The possible causes are:

    • The installation package was uploaded.
    • The data disk image was uploaded.
    • The boot partition image was uploaded.
    • An incorrect file was uploaded.

    InternalError: unknown error


    The InternalError error indicates that the cause of error has not yet been recorded. Contact the customer service and our technical personnel will help you resolve the issue.

    Error codes

    Error Code Description Troubleshoot
    InvalidUrl Invalid COS URL Check whether the COS URL is the same as the imported image URL.
    InvalidFormatSize The format is incorrect or the size is too large. Check the format and size of the image as described in Preparations.
    VirtioNotInstall The Virtio driver has not bee installed. Install the Virtio driver in the image by referring to the Driver section in Preparations.
    PartitionNotPresent Partition information not found. Image is corrupted possibly due to incorrect image creation method.
    CloudInitNotInstalled Cloud-init software not installed. Install cloud-init in the Linux image by referring to the Driver section in Preparations.
    RootPartitionNotFound Root partition not found. Image is corrupted possibly due to incorrect image creation method.
    InternalError Other errors. Contact our customer service.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support