Docs

Elastic Compute Service

Batch operations on instances

Creating tasks for batch instance operations

You can create a task for batch instance operations to perform the same operation on multiple ECS instances at the same time. The operations include command delivery, file downloading, instance operations, and attribute modification.

Command delivery: Execute relevant commands inside the instance by delivering scripts. For example, you can execute a specific command to view the IP address.

File downloading: Download multiple target files at the same time to the specified instance.

Instance operations: Perform O&M operations on instances, including starting, stopping, and restarting instances, and changing the operating system.

Attribute modification: Modify the attributes of instances, including the instance names, hostnames, and descriptions.

Prerequisites

You have completed preparations.

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 "Create task" button, refer to the table below, and select the task type and instances.

Run command

Download a file

Instance actions

Attribute modification

tip

The instances must be in the Running status.

Cloud assistant client is installed. For operation details, refer to Installing cloud assistant Agent.

Parameter	Description	Sample value
Select task type
Type	Select the type of O&M command that you want to execute.	Run command
Command type	Select the type of O&M command that you want to execute. Valid values: Linux Shell, Python, Windows Bat, and Windows PowerShell.	Linux Shell
Command contents	Enter a specific command according to your business requirements. This way, an O&M task is created to execute the command you enter.	-
Execute path	Enter the command execution path. For Linux instances, the default path is "/home". For Windows instances, the default path is "C:/Windows/System32".	/home
Execute user	Specify a user that exists in an instance to execute commands to reduce security risks. The default user to execute commands is root in Linux. The default user to execute commands is system in Windows.	root
Select instances
Select instances	Determine target (ECS) instances that meet the batch execution requirements using information such as instance name/ID, running status, and cloud assistant installation status, supporting the selection of multiple instances. tip Instances without cloud assistant installed do not support batch execution. Please first install the cloud assistant Agent. You can select up to 500 ECS instances.	-

tip

The instances must be in the Running status.

Only one file can be uploaded per task.

Cloud assistant Agent installed, view operating details in Install the cloud assistant Agent.

Parameter	Description	Sample value
Select task type
Type	Select the type of O&M command that you want to execute.	Download a file
File type	Default is HTTPS file, modification is not supported.	Retain the default value.
File link	Fill in the link to the file to be downloaded, which is the link to the remote file accessed securely via the HTTPS protocol. tip The maximum length of a file link is 2,000 characters.	https://xx/xx or http://xx/xx
File save path	Fill in the storage path after the file is downloaded, which is the complete path where the file is stored on the target ECS instance.	/root/testxx
Advanced settings
File owner	Optional. The user to which the file belongs after the file is uploaded.	-
File group	Optional. The user group to which the file belongs after the file is uploaded.	-
File permissions	Optional. The permission on the file after the file is uploaded. For example, if you set this parameter to 644, the owner has read and write permission on the file, and users in the same group and public users have read-only permission on the file.	644
Override the existing file	Select whether the downloaded file overwrites the existing file. By default, the downloaded file overwrites the existing file.	Default configuration
Select instances
Select instances	Determine target (ECS) instances that meet the batch execution requirements using information such as instance name/ID, running status, and cloud assistant installation status, supporting the selection of multiple instances. tip Instances without cloud assistant installed do not support batch execution. Please first install the cloud assistant Agent. You can select up to 500 ECS instances.	-

tip

Start: Only instances in the stopped status can be started.

Stop: Only instances in the running status can be stopped.

Restart: Only instances in the Running status can be restarted.

Replace the operating system After you change the operating system, the system volume ID is changed, and the original system volume data is cleared and released. This operation is irreversible. Proceed with caution. For more usage limits, refer to Precautions.

Cloud assistant Agent installed, view operating details in Install the cloud assistant Agent.

Parameter	Description	Sample value
Select task type
Type	Select the type of task for which you want to execute O&M commands.	Instance actions
Action type	Select the type of operation you want to perform. Valid values: Start: Start the instances in the Stopped status. Stop: Stop the instances in the Running status. The stop methods include "Stop" and "Forced stop". The stop modes include "Normal Mode" and "Economical Mode". For information about stop modes, see Stop modes. Stop: the default and regular method that follows the standard procedure for stopping ECS instances. Forced stop: The running ECS instances are forced to stop, which is equivalent to a power-off operation. warning If you perform a forced stop on instances other than bare metal instances, all cache data that has not been written to the storage devices is lost. We recommend that you do not perform this operation on instances that are running as expected. Restart: Restart the instances that are in the Running status. Restart: the default and standard restart mode. Forced restart: Forcibly power off the running instance and then restart it. warning For instances other than bare metal instances, performing a forced restart will result in the loss of all cached data not stored to storage devices to be lost. Therefore, we recommend against performing this operation on instances running normally. Replace the operating system: This operation restores the instances to the initial status and is commonly used to recover instances from system failures. For more information, see Changing operating systems. tip We recommend that you change operating systems for instances in the Stopped status. Otherwise, data that is being written may be lost. If your instances are not in the Stopped status, stop the instances. For more information, see Stopping instances.	Start
Select instances
Select instances	Determine target ECS instances that meet batch operation requirements based on information such as instance name or ID, and running status. You can select multiple instances at the same time. tip You can select up to 500 ECS instances.	-

tip

Only instances whose status is Running or Stopped support attribute modification.

If the instance status is Running, changing the hostname automatically restarts the instances.

Instances created using CentOS 6.9/6.10 or Ubuntu 14.04 do not support hostname changes.

Cloud assistant Agent installed, view operating details in Install the cloud assistant Agent.

Parameter	Description	Sample value
Select task type
Type	Select the type of task for which you want to execute O&M commands.	Attribute modification
Select instances	Determine target ECS instances that meet batch operation requirements based on information such as instance name or ID, and running status. You can select multiple instances. tip You can select up to 500 ECS instances for a task.	-
Modify attributes
Edit	Modify attributes of a single instance, including the instance name, hostname, and description. Specific steps are as follows: tip Hostname: The hostname is the computer name within the instance operating system and is used to identify the computer on the network. Click the target instance. Select the attribute to modify, and click the icon to modify the attribute. For more information, see Naming rules for instances or hosts. After you modify the attribute, click the icon to save the modification.	-
Copy All	Use the name, hostname, or description of an instance as a template to modify the attributes of all selected instances at the same time. The attributes include the instance name, hostname, and description. Perform the following steps: After you select an instance, click the icon in the corresponding attribute column. Click the "Copy All" button to save your modification.
Copy up/Copy down	Use the name, hostname, or description attribute of an instance as a template to modify this attribute for all instances above or below this instance at the same time. Specific steps are as follows: 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.

Refer to the table below, configure concurrency control and related information.

Parameter	Description	Sample value
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	Specifies the maximum number or percent of errors allowed when executing a batch instance task within a specific operation or range. Error count: Generally applies to scenarios where the error count needs attention, and the value range is 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 the project and manage it uniformly by project dimension, which helps maintain resource independence and ensure data security. For more information about projects, see Project management.	default
Tag	A tag is a key-value pair used to identify 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 Tag management.	Key1:Value1

Click "Create".

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.