Docs

Elastic Compute Service

Process choreography

Managing orchestration tasks

This topic describes how to create and manage orchestration tasks.

Prerequisites

You have completed the preparations.

Create an O&M orchestration task

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

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

Click the "Orchestrate tasks" tab.

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

The parameters.	Description	Sample value
Basic information
Name	Specify the name of the orchestration task.	Creating custom images
Role	Select a role with permission to perform operations on the service for which the orchestration task is created. The default role is "CustomRoleForOOS", which has full read and write access to ECS. You can also click the "Role" drop-down list to select a different role. The selected role must have permissions to perform operations on the corresponding resource. tip You can add task steps and then click the "View required task permissions" button to view the permissions needed for the role executing this orchestration task.	Retain the default value.
Project	You can add orchestration tasks to a project and manage them by project, which helps maintain resource independence and data security. For more information about project management, refer to 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 easily search and aggregate your resources. For more information about tags, refer to Tag management.	Key1:Value1
Execution mode
Execution mode	For the job execution modes, the following options are available: Execute immediately: After the job is created, it is executed for one time immediately. Timed execution: The task is executed automatically once at the time you specify. tip The execution time must be accurate to the minute and must not be earlier than the current time. Periodic execution: The task is executed automatically on a cycle starting from the specified start time, at intervals you specify (in minutes, hours, or days), and stops automatically at the specified end time. You need to configure the following information: Repeat cycle: Specify the interval at which the job is executed repeatedly. The repeat interval must be longer than the timeout period. Value: by minute: The minimum interval is 5 minutes. by hour: The minimum interval is 1 hour. by day: The minimum interval is 1 day. Start time: Specify the time when the periodic job is first executed. This time must be later than the current time. Stop time: Specify the time when the periodic task stops. The task automatically stops at this time. If the task is not being executed at the stop time, it automatically stops and will never be executed again. If the job is being executed at the stop time, it automatically stops after the execution is complete and will never be executed again. If the interval between the stop time and the start time is less than one repeat cycle, the task is executed only once. Time zone: Fixed to GMT +08:00 (China Standard Time). tip The execution interval is independent of the actual execution duration of the task and is calculated based on the "Start time" you specify. For example, if the start time for a job is 2022-12-20 11:00:00, the repeat cycle is 1 hour, and the duration of the first execution is 3 minutes, the second execution starts at 2022-12-20 12:00:00.	Execute immediately
Task step
Add step	Add the steps you want to execute one by one in your desired order. Click the "Add step" button, and select the required step in the pop-up window. After you add a step, the system automatically assigns an ID to the step, making it easier to distinguish steps with the same feature. For example, the ID for a step that creates an ECS instance is id:437a. Click the "Add" button to complete the addition. Configure parameters for each step. You can configure input and output parameters for each step. Once a step is executed, the relevant information is displayed. For parameters supported by each step, see Summary of orchestration steps. Select the "Input" tab and configure the input parameters required for step execution. Parameter sources: warning The first step only allows you to manually enter parameter values. Custom input: Select or enter parameter values. From the preceding task: You can select the output parameter values of the preceding steps in the O&M orchestration as parameter values. Select the "Output" tab to view information about the parameters returned after the current step is executed. Click the icon to add more steps based on your business requirements. You can reorder the added steps by dragging them.	Create ECS instances

Click the "Create" button. After the creation, the system will automatically redirect you to the orchestration list page and start executing the orchestration task based on the execution method you configured.

You can click the target task name to view task execution information. For more information, see View task details.

View task details

On the task details page, you can view task information, the execution status of each task step, and historical logs, including logs of each step and global logs of the orchestration task.

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

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

Click the target task name to view the information described in the following table.

Parameter	Description
Overview	Click the "Overview" tab to view the basic information, mode, and task template of the orchestration task. Basic information: includes information such as the task name, role, task ID, and associated project. Mode: includes execution mode and execution time. Task template: All task templates used in this orchestration task and the names of the task templates.
execute	Click the "execute" tab to view execution records of the orchestration task. tip Only one execution record exists if you set "Mode" to "Execute immediately" or "Timed execution". Click the "View details" button to view task execution details, including the execution status of all steps in the current task. Click any step to view the basic information, input/output arguments, loop task list, and log details for that step. tip Only tasks created in the orchestration console support viewing input/output arguments. Only tasks that include loop tasks (executed in batches) enable you to view the loop task list, including the execution objects and status of the loop tasks. Examples include "batch instance operations" and "batch key pair association." Click the "View subtask" button to view the details of the subtasks. If the task status is Success, all subtasks succeed. If the task status is Fail, all subtasks fail. If the task status is Partial Failure, at least one subtask succeeds and at least one subtask fails.
Log	Click the "Log" tab to view the global execution log for the orchestration task.

After the task is successfully executed, you can go to the relevant cloud product page to view the execution results.

For example, you can go to the "Instances" page and check whether the instance is running as expected after the operating system is changed.

Clone an orchestration task

You can use the cloning feature to replicate an existing task, including its execution method, steps, and parameters. You can also adjust the configuration based on the original task, facilitating efficient task management and execution.

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

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

Click the "Clone" button in the "Actions" column of the target operations orchestration task to access the "Clone task" page.

(Optional) Adjust the task information based on your needs, refer to Create an orchestration task for parameter descriptions.

Click the "Clone" button to complete the cloning operation.

After the task is successfully cloned, the system will automatically redirect you to the orchestration list page and immediately start executing the orchestration task.

You can click the target task name to view task execution information. For more information, see View task details.

Cancel an orchestration task

You can manually cancel orchestration tasks, canceling all current and subsequent executions.

warning

You can cancel only orchestration tasks in the Waiting for execution or in progress status.

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

In the left-side navigation pane, select "Maintenance & Monitoring > Orchestration" to go to the orchestration list page.

Click the "Cancel" button in the "Actions" column of the target orchestration task.

After you confirm the target orchestration information in the pop-up window, click the "Cancel" button to complete the operation.

Delete an orchestration task

You can delete orchestration tasks that are no longer needed to reduce redundant information.

warning

You cannot delete orchestration tasks in the Waiting for execution or in progress status.

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

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

Click the "Delete" button in the "Actions" column of the target orchestration task.

After you confirm information of the orchestration task you want to delete, click the "Delete" button to complete the operation.

Last updated: 2026.06.18 17:49:52