Docs

Elastic Compute Service

Sharing image

Copying shared images

If you want to modify an image shared with your account or use the shared image across regions, you can copy the image as a custom image and perform operations on the custom image.

Usage notes


Shared image
Management restrictions	Image sharing cannot be canceled while the shared image is being copied.
Target image
Region	You can copy a shared image only to the region in which the shared image is located.
Image quantity	The number of existing custom images in the target region must be less than 50.
License types	The license type of the target image must be consistent with that of the shared image.
System volume	If the system volume capacity of the shared image is less than 20 GiB, the VolcanoEngine platform automatically adjusts the system volume capacity of the target image to 20 GiB.
Data replication
The project and tag attributes of the shared image will not be copied to the target image.

Procedure

On the image list page, select the "Shared Image" tab.

In the top menu bar, select the project and region to which the source image belongs.

Click "Copy Image" in the "Actions" column to the right of the shared image to be copied.

In the "Copy Shared Image" pop-up window, complete the following configuration.

Parameter	Description	Sample value
Custom image name	Enter the name of the custom image displayed in the target region.	copy_image
Project (optional)	Select the project to which the custom image belongs. Once the project is selected, the replicated custom image can only be viewed and used by users with permissions on that project. If no project is available in the drop-down list, you can follow the guidelines to create a project. For more information, see Creating projects. If you want to change the project to which the image belongs after the image is copied, refer to Managing project resources. tip A project is a collection of resources. You can add custom images to projects and classify and manage custom images by project. Additionally, you can control the permissions of users and roles within each project on custom images. For more details, refer to Resource management. You can copy a custom image belonging to project A to project B, but the account performing the image copy action must have operational permissions on both project A and project B. For information about how to authorize an account to manage projects, refer to Managing permissions on projects.	projectA
Tag (optional)	Configure the tag information of the target image. tip A tag is a key-value pair used to identify cloud resources. Tags help you categorize cloud resources with similar attributes based on different dimensions, such as purpose, owner, or environment. This allows you to search and aggregate your cloud resources for easy management. For more information, refer to Tag overview.	-

Click "Copy" to replicate the shared image.

You can copy the image ID in the pop-up window, go to the "Custom Image" tab in the target region, and view the replication progress.

tip

When the replication task is in progress, the status of the target image is Creating. After replication is complete, the status of the target image turns to Available. In this case, an independent new image with a unique image ID and a snapshot is generated in the target region. For snapshot billing details, refer to Snapshot overview.

Subsequent operations

You can use the replicated image to purchase instances or change the instance operating system. You can also deploy an image across regions by using the custom image replication feature.