Docs

Elastic Compute Service

Batch operations on images

Creating tasks for batch image operations

You can use Orchestration to batch create custom images or batch distribute images for multiple existing instances (copy images and share images). For more information about image definition, fees, and limits, see Image overview.

Prerequisites

You have completed preparations.

If you want to create Linux images, you have already cleared the Cloud-Init configuration.

If you want to create Windows images, you have already cleared the network interface information.

Limits

Feature/Parameter	Limit
Send a remote command (optional)	Send remote commands only to instances with the cloud assistant Agent installed. For more information, see Installing cloud assistant Agent.
Share an image (optional)	You can share custom images with main accounts only. For information about how to view account IDs, see Account overview. Do not include data that is not suitable for public disclosure in an image. After an image is shared, the receiving account can access the data stored in the image.
Copy an image (optional) tip The image copy feature is currently only available to accounts that have completed enterprise real-name authentication. For more information, see Enterprise authentication and Upgrading individual authentication to enterprise authentication. This feature is in Beta. If you need a trial, contact your account manager.	You can copy a custom image in the following regions: China (Shanghai)(cn-shanghai) China (Beijing)(cn-beijing) China (Guangzhou)(cn-guangzhou) China (Hong Kong) (cn-hongkong)

Usage note

When you create custom images, the system automatically creates the relevant snapshots. Before you delete the snapshots, you need to first delete the associated images.

When you create custom images from instances running the Linux system, make sure that the '/etc/fstab' configuration file does not contain any data volume configuration information. Otherwise, instances created by using the custom images cannot start as expected. For more information, see fstab configuration of Linux instances.

The region of a new image is the same as the region of the instance for which the image is created. For more information, see Operation instructions.

Procedure

In the left-side navigation pane, click "Maintenance & Monitoring > Orchestration".

In the top menu bar, select the region where your business is located.

On the "CloudOps Orchestration" page, click the "Common tasks" tab.

Click the "Batch operations on images" menu.

Click the "Create task" button and configure the parameters described in the following table.

Parameter	Description	Sample value
Select task type
Type	Select the type of O&M command that you want to execute. The default type is "Create image".	Creating images
Select instances
Select instances	Determine target instances that meet batch operation requirements based on information such as instance name or ID, running status, and instance type. You can select multiple instances. tip You can select up to 100 instances at the same time.	-
Fill in the image information
Edit	After you select an instance, the "Image Name", "Image type", and "Project" parameters are automatically generated. You can modify the parameters based on your business requirements. You can also add a description and tag to the image. Image type: System volume image: A custom image that contains only the data from the system volume. Whole Image: A custom image that contains data from both the system volume and data volumes. For more information, see Whole image operation instructions.	-
Copy All	Use a parameter of an instance as a template to modify this parameter for all selected intances at the same time. All parameters except for the "Instance name/ID" parameter support "Copy All". The modification procedure is the same across parameters. For example, to copy the image tag, perform the following steps: After you select an instance, click the icon in the "Image tag" column of the instance. Click the "Copy All" button to save your modification.
Copy up/Copy down	Use a parameter of an instance as a template to modify this parameter for all instances above or below this instance at the same time. All parameters except for the "Instance name/ID" parameter support "Copy up" and "Copy down". The modification procedure is the same across parameters. For example, to copy the image type, perform the following steps: After you select the target instance, click the icon in the "Image type" column of the instance. Click the "Copy up" or "Copy down" button to save your modification.
Send a remote command (optional)
Remote command setup	Execute relevant commands inside the instance by delivering scripts. For example, you can execute a specific command to view the IP address. Supported: tip Commands can only be sent to instances running the same type of operating system. For example, Linux commands must be sent to Linux instances. Otherwise, the task will fail as the commands cannot be executed. Enable: If you select "Enable remote command sending", you can send remote commands by using "Linux Shell", "Python", "Windows Bat", or "Windows PowerShell". For detailed instructions, see Batch operations on instances. Do not enable (default): If you do not select "Enable remote command sending", remote commands will not be sent.	-
Image distribution (optional)
Target region	Select the target region. This parameter is required when you want to copy the images (source custom images) and their configurations to another region, for purposes such as cross-region deployment of ECS instances and cross-region backup of data. tip The target region must be different from the source region.	China (Beijing)
Image sharing account	Enter the IDs of the receiving accounts. Separate multiple account IDs with Enter keys. tip Each image can be shared with up to 50 main VolcanoEngine, accounts. For information about how to view account IDs, see Account overview. If you no longer want to share an image with an account, you can cancel image sharing on the image list page.	210005****
Concurrency control
Concurrency rate	Specify the number of concurrent executions for a batch instance task, which refers to the maximum number of instances that can undergo operations or receive requests at the same time. For example, if you have 50 instances and set this parameter to 10, the task will be executed in 5 batches, and commands will be sent to 10 instances simultaneously in each batch. Value range: 1-100.	10
Maximum error count	When specifying batch image tasks to execute within a particular operation or range, the maximum allowable number or percentage of errors is set. Error count: Generally applicable to scenarios focusing on error count, with a range of 0-100. If the error count is set to 0, no errors are allowed. That is, if an error occurs even once while performing a task, the entire task will stop (fail). If the error count is set to 100, a maximum of 100 errors is allowed. That is, as long as the number of errors during the execution of a task does not exceed 100, the task will succeed, but if errors exceed 100 before the task is completed, the entire task will stop (fail). tip The next step is allowed to proceed only when the actual number of failures across all batches of the task is less than or equal to the maximum number of errors you specify. Percent: Applicable to scenarios where the impact of errors on the entire task needs attention. Value range: 0-100%. If the maximum error percent is set to 0%, no errors are allowed. That is, if an error occurs even once while performing a task, the entire task will stop (fail). If the maximum error percent is set to 100%, the task will succeed regardless of the number of errors. tip The next step is allowed to proceed only when the actual failure rate (percentage of failed instances) across all batches of the task is less than or equal to the maximum error rate (percentage) you specify.	Error quantity: 1
Relevant Information
Project	You can add the Cloud assistant to a project and manage it uniformly by project dimension, conducive to maintaining resource independence and ensuring data security. For more information about projects, see Project management.	default
Tag	A tag is a key-value pair used to identify cloud resources. Tags help you categorize resources based on different dimensions, such as purpose, owner, or environment. This allows you to search and aggregate your resources. For more information about tags, see Tags.	Key1:Value1

Click the "Create" button.

After you confirm that the configuration information is correct, click the "Confirm" button to start task execution.

The selected task is executed on the selected instances, which has a wide-ranging impact. Confirm that all information is correct before you submit the request.

The time required to create custom images depends on the actual sizes of the system volumes. Be patient.

Subsequent steps

After the task is successfully executed, you can perform the following operations:

You can view the image status in the custom image list. If the status of a custom image is Available, the custom image is created. For more information, see Viewing image creation results.

(Optional) If an image you create has been shared with other accounts, you can view the shared image with the "Shared" tag in the custom image list.

(Optional) If an image you create has been copied to another region, you can view information about the image copy task in the target region. For example, if you copy a custom image from the China (Guangzhou) region to the China (Beijing) region, you need to go to the China (Beijing) region to view the task information.

Last updated: 2026.06.18 17:49:52