Docs

Elastic Compute Service

Creating custom images

Creating custom images by using snapshots or snapshot consistency groups

This topic describes how to create a custom image by using a snapshot or a snapshot consistency group.

Prerequisites

The snapshot feature is enabled.

The system volume snapshot or the snapshot consistency group is created, and neither the snapshot nor the snapshot consistency group is associated with an image ID.

Procedure

Create a custom image by using a snapshot

warning

You can create a custom image by using a snapshot created exclusively for a system volume.

In the left-side navigation pane, click "Storage > Snapshots".

In the top menu bar, select the project and region where the target snapshot is located.

Select the "Snapshots" tab.

Click "... > Create custom image" in the "Actions" column of the target snapshot.

On the "Create custom image" page, check the snapshot information and configure the following parameters.

Parameter	Description	Sample value
Image name	Specify the name of the custom image.	CentOS7-FromSnapshot
Project (optional)	Select the project to which the custom image belongs. After you select a project, the created custom image can be viewed and used only by users with permissions on the 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 created, 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. Learn more.	projectA
Image detection (optional)	Specify whether to enable the image detection feature. This feature checks whether your custom image meets the image requirements of the platform. This helps ensure that the ECS instances created by using the custom image run as expected. tip The image detection process starts after a custom image is created. Interrupted checks or failed checks do not block the creation or import process of the custom image. Learn more.	-
Tag (optional)	Click the + icon and enter the tag key and tag value to add tags to the 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. Learn more.	Key:Value

After you configure the parameters, click "Create custom image" to submit the image creation request.

You can view the progress of creating a custom image on the "Custom Image" tab or the "Executions" page.

In the left-side navigation pane, click "Instances & Images > Images", and then select the "Custom Image" tab to view the creation progress.

In the left-side navigation pane, click "Maintenance & Monitoring > Executions", and view the creation progress on the "Executions" page.

Create a custom image by using a snapshot consistency group

In the left-side navigation pane, click "Storage > Snapshots".

In the top menu bar, select the project and region where the target snapshot is located.

Select the "Snapshot Groups" tab.

Click the "Create custom image" button in the "Actions" column of the target snapshot consistency group.

On the "Create custom image" page, check the snapshot consistency group information and configure the following parameters.

Parameter	Description	Sample value
Image name	Specify the name of the custom image.	CentOS7-FromSnapshotConsistencyGroup
Project (optional)	Select the project to which the custom image belongs. After you select a project, the created custom image can be viewed and used only by users with permissions on the 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 created, 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. Learn more.	projectA
Image detection (optional)	Specifies whether to enable the image detection feature. This feature checks whether your custom image meets the image requirements of the platform. This helps ensure that the ECS instances created by using the custom image run as expected. tip The image detection process starts after a custom image is created. Interrupted checks or failed checks do not block the creation or import process of the custom image. Learn more.	-
Tag (optional)	Click the + icon and enter the tag key and tag value to add tags to the 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. Learn more.	Key:Value
System volume only	Specify whether to use only the system volume snapshot in the snapshot consistency group to create the custom image.	-

After you configure the parameters, click "Create custom image" to submit the image creation request.

You can view the progress of creating a custom image on the "Custom Image" tab or the "Executions" page.

In the left-side navigation pane, click "Instances & Images > Images", and then select the "Custom Image" tab to view the creation progress.

In the left-side navigation pane, click "Maintenance & Monitoring > Executions", and view the creation progress on the Executions page.

Operation results

In the top menu bar, select the region and project where the target custom image is located.

Select the "Custom Image" tab.

If the status of the target image is Available in the "State" column, the custom image is created.

You can also click the image name to go to the image details page, select the "Associative snapshot" tab, and view the IDs of the snapshots associated with the volumes in the image, the volume types, and the capacity of the volumes. For information about the snapshot feature, see Snapshot overview.

Last updated: 2025.10.29 11:49:14