You can export custom images that you created to OSS buckets, and then download the images to local computers. This topic describes the considerations for exporting custom images and how to export custom images.


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

    If you have not created any OSS buckets, create one. For more information, see Create buckets.

    Note Exporting a custom image will incur OSS storage fees and traffic fees. For more information, see Overview.
  • The custom image to be exported meets the following requirements:
    • It was 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.

Background information

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

  • The time it takes to export a custom image depends on the size of the image and the number of ongoing export 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 any data when the custom image is created, the decompressed image file will not contain any data either.


  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. In the Actions column corresponding to a custom image, choose More > Export Image.
    2. In the Export Image dialog box that appears, click Verify.
      Export a custom 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 target image. In the Actions column corresponding to the image, choose More > Export Image.
  7. In the Export Image dialog box, set the following parameters:
    • Image Format: Select a format in which to export the custom image. Valid values: RAW, VHD, QCOW2, VDI, and VMDK.
      Note This feature is available in some regions and will be available in more regions soon.
    • 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] in the OSS bucket.
  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 system, we recommend that you use GNU Tar to decompress the image.