You can export a created custom image to an Object Storage Service (OSS) bucket and download the image to local computers. This topic describes how to export custom images and what notes must be taken of.


  • An OSS bucket is available in the same region as the custom image to be exported.

    If you do not have OSS buckets available in the region, create an OSS bucket. For information about how to create an OSS bucket, see Create buckets.

    Note When you export a custom image, you are charged for OSS storage and the traffic generated for image download. For more information, see Overview.
  • The custom image to be exported meets the following requirements:
    • It is not created based on an Alibaba Cloud Marketplace image.
    • It does not contain a Windows Server operating system.
    • It does not contain snapshots of more than four data disks. The size of each data disk does not exceed 500 GiB.
      Note If the capacity of a data disk exceeds 500 GiB, you must distribute the data on the disk to multiple data disks that are smaller than 500 GiB in size and then create and export custom images from these smaller data disks.

Background information

Before you export a custom image, take note of the following points:

  • The amount of time it takes to export a custom image depends on the size of the image and the number of concurrent tasks in the queue.
  • If an exported custom image contains data disk snapshots, multiple objects appear in your OSS bucket.

    Objects whose names contain system are system disk snapshots. Objects whose names contain data are data disk snapshots. The identifier of a data disk snapshot is the mount point of the source data disk, such as xvdb and xvdc.

  • To use the exported image to create identical Linux instances, make sure that the storage location and storage space division of files recorded in /etc/fstab are consistent with the exported data disk snapshot information.
  • If the cloud disk does not contain data when the custom image is created, the decompressed image file also does not contain data.
  • The exported image may not be normally started on instances that run operating systems different from the images, but you can mount the disk in the image to obtain data.


  1. Log on to the ECS console.
  2. In the left-side navigation pane, choose Instances & Images > Images.
  3. In the top navigation bar, select a region.
  4. Authorize ECS to access OSS.
    1. Find the image that you want to export. In the Actions column, click the The More icon icon, and then click Export Image.
    2. In the Export Image dialog box, click Verify in the notes.
      Export an image
    3. In the Cloud Resource Access Authorization dialog box, click Confirm Authorization Policy to allow ECS to access your OSS resources.
  5. In the left-side navigation pane, choose Instances & Images > Images.
  6. On the Custom Images tab, find the image that you want to export and choose More > Export Image in the Actions column.
  7. In the Export Image dialog box, configure the following parameters:
    • Image Format: Select a format in which to export the custom image. Valid values: RAW, VHD, QCOW2, VDI, and VMDK.
      Note The feature of selecting image export formats is available only in some regions.
    • OSS Bucket Address: Select an OSS bucket that belongs to the same region as the custom image.
    • OSS Object Prefix: Set the prefix of the object name for the custom image. For example, if you set OSS Object Prefix to Demo, the exported image is named Demo-<Automatically generated object name>.
  8. Click OK to export the custom image.

    You can cancel an image export task at any time before the task is complete. Go to the Tasks page in the ECS console, find the corresponding task in the specified region, and cancel the task.

What to do next

Download the custom image. For more information, see Download objects.
Note If you select the RAW image format, the default file name extension of the exported custom image is .raw.tar.gz, and the file name extension of the decompressed image is .raw. If your local computer runs a Mac OS X operating system, we recommend that you use GNU Tar to decompress the image.