Import an image in the console

Last Updated: May 21, 2018

You can import image files to the ECS environment to create custom images. You can then use these images to create ECS instances.


  • See Notes for importing custom images, Configuration of Customized Linux and Convert image file format for the restrictions and requirements when you import the custom image.
  • You must enable the OSS service, and make sure that you must grant the official ECS service account access to your OSS.
  • You can only import an image file to a region from OSS in the same region. The image and the OSS must belong to one account.
  • You can use an OSS third-party tool client, OSS API or OSS SDK, to upload the file to a bucket in the same region as the ECS custom image to import. See Multipart upload to upload an image file that is larger than 5 GiB.


  1. Log on to the ECS console.

  2. In the left-side navigation pane, choose Snapshots and Images > Images.

  3. Click Import Image.

  4. Click Confirm Address on the third items of How to import an image.

  5. Click Confirm Authorization Policy.

  6. In the left-side navigation pane, choose Snapshots and Images > Images.

  7. Choose a region.

  8. Click Import Image, and enter the following information in the pop-up window.

    • Region of image
      Select the region where you want to deploy the application.

    • OSS Object Address
      Copy the object address taken from the OSS console.

    • Image Name
      The length must be 2 to 128 characters. It can contain uppercase letters, lowercase letters, or Chinese characters. It cannot contain numbers, underscores (_), or hyphens (-).

    • Operating System
      Supported OS releases are:

      • Windows
      • Linux
    • System Disk Size

      • For Windows system: 40 - 500 GiB.
      • For Linux system: 40- 500 GiB.
    • System Architecture
      64-bit OS: x86_64. 32-bit OS: i386.

    • System Platform
      Supported operating system releases are:

      • Windows: Windows Server 2003, Windows Server 2008, and Windows Server 2012.
      • Linux: CentOS, SUSE, Ubuntu, Debian, FreeBSD, and CoreOS.
        • (Linux only) Open a ticket to Alibaba Cloud to confirm the selected edition is supported.
        • If your image OS is a custom edition developed on a Linux kernel, open a ticket to Alibaba Cloud.
    • Image Format
      Supports RAW and VHD format. RAW format is recommended.
      Note: You cannot use qemu-image to create VHD images.

    • Image Description
      The description of the image.

  9. Click OK.

Note: It usually takes 1 to 4 hours to import an image, and the duration of the task depends on the size of your image file and the amount of concurrent tasks. You can view the task progress in the image list of the import region.

You can find and cancel the image import task in the task manager.

Follow-up operation

After you import the custom image, you may want to create an instance by using a custom image.

Thank you! We've received your feedback.