Creating a Scheduled Task

Constraints

• Each account can create a maximum of 200 scheduled tasks.
• A maximum of 999 instances can be selected for a task.

Creating a Scheduled Task

1. Log in to COC.
2. In the navigation pane, choose Resource O&M > Automated O&M.
3. In the Routine O&M module, click Scheduled O&M. The Scheduled O&M page is displayed.
4. Click Create Task.
5. Set Basic Information.

   Table 1 Basic information parameters

   Parameter	Description
   Task Name	Customize a task name based on the naming rules. The value can contain 3 to 100 characters, including letters, digits, hyphens (-), and underscores (_).
   Enterprise Project	Select an enterprise project from the drop-down list.
   Version	Enter the script version number.
   Risk Level	Select High, Medium, or Low based on service requirements.

6. Set parameters in the Scheduled Settings area.

   Table 2 Parameter description

   Parameter	Description
   Time Zone	Select the time zone where the scheduled task is executed from the drop-down list.
   Timing Type	Select a scheduled type. Single execution: A scheduled task is executed once at a specified time. Periodic execution: A task is periodically executed based on the specified rule until the rule expires.
   Execution Time	It is used together with the timing type. For a one-time execution, set this parameter to the execution time. For periodic execution, select either of the following options: Simple: Select the execution time by week. Cron: Set the execution time using a cron expression. For details, see Using Cron Expressions.
   Rule Expired	This parameter needs to be set when Timing Type is set to Periodic execution. Configure the end time of the rule. The scheduled task is executed periodically based on the user-defined execution period until the rule end time.

7. Select Task Type and set the task configuration based on the selected type.

   Set Task Type to Scripts.

   • If Task Type is set to Scripts, set the task by referring to Table 3.

     Table 3 Script task configuration description

     Parameter	Description
     Scripts	Select a script from the drop-down list. You can select a custom script or public script. For details about how to create a script, see Creating a Script.
     Script Input Parameters	If the script does not have input parameters, you do not need to set them.
     Executed By	User root is used by default, which is the user who executes the script on the target instance node.
     Timeout Interval	300 is used by default. It indicates the timeout interval for executing the script on a single target instance.
     Target Instance	Click Add and select an instance by referring to Table 4.
     Batch Policy	Select Automatic, Manual, or No Batch. Automatic: The selected instances on which you want to perform operations are automatically divided into multiple batches based on the default rule. Manual: You can manually create multiple batches and add instances to each batch as required. No Batch: All instances on which you want to perform operations are in the same batch.
     Suspension Policy	You can set a target execution success rate. If the number of failed servers reaches the threshold derived from this success rate, the service ticket is flagged as abnormal and execution stops immediately. The success rate ranges from 0 to 100 with precision to one decimal point.

     Table 4 Parameters for selecting an instance

     Parameter	Description
     Selection Method	Select an instance selection method. Manual Selection: Manually select one or more instances based on settings of Enterprise Project, View Type, Resource Type, Region, and Target Instance. Select All: The system automatically selects all instances based on settings of Enterprise Project, View Type, Resource Type, Region, and Target Instance.
     Enterprise Project	Select an enterprise project from the drop-down list. You can choose All.
     View Type	Select a view type. CloudCMDB resources: Select an instance by resource type. CloudCMDB application groups: Select an instance by application group.
     Resource Type	Resource type of the target instance. The value can be ECS, BMS, or FlexusL.
     Region	Select a region from the drop-down list.
     Target Instance	Set filter criteria in the filter box and select the displayed instances manually or automatically.

   Set Task Type to Jobs.

   • If Task Type is set to Jobs, set the task by referring to Table 5.

     Table 5 Job task configuration description

     Parameter	Description
     Jobs	Select a job from the drop-down list. You can select a custom job or public job. For details about how to create a job, see Creating a Job. Click a task name under job steps and check API parameters. If the task needs to be executed on instances, set the range of instances on which you want to execute the task in advance to avoid misoperations. Note: If the selected job step contains control actions, such as pause, review, and sleep, scheduled O&M does not support such configurations. For scheduled O&M tasks that need to be executed on instances, in the batch execution scenario, you can only continue all tasks. In this case, if you choose to pause all tasks or pause the first batch, the system will continue all tasks by default.
     IAM Agency	Scope of permissions that can be used on COC to execute jobs.
     Target Instance Mode	Select the execution mode for job steps and target instances. Consistent for all steps: All tasks are executed on the selected instances using the same batch policy. Unique for each step: Tasks in one step are executed on the selected instance. Each step uses a batch policy. Unique for each task: Set the target instances and batch policy for each task.
     Job Execution Procedure	You can customize job details. Click a job name. The drawer for modifying parameters is displayed on the right. Set parameters on the Input, Output, and Troubleshooting tab pages.
     Target Instance	Click Add and select an instance by referring to Table 6.
     Batch Policy	Select Automatic, Manual, or No Batch. Automatic: The selected instances on which you want to perform operations are automatically divided into multiple batches based on the default rule. Manual: You can manually create multiple batches and add instances to each batch as required. No Batch: All instances on which you want to perform operations are in the same batch.

     Table 6 Parameters for selecting an instance

     Parameter	Description
     Selection Method	Select an instance selection method. Manual Selection: Manually select one or more instances based on settings of Enterprise Project, View Type, Resource Type, Region, and Target Instance. Select All: The system automatically selects all instances based on settings of Enterprise Project, View Type, Resource Type, Region, and Target Instance.
     Enterprise Project	Select an enterprise project from the drop-down list. You can choose All.
     View Type	Select a view type. CloudCMDB resources: Select an instance by resource type. CloudCMDB application groups: Select an instance by application group.
     Resource Type	Resource type of the target instance. The value can be ECS, BMS, or FlexusL.
     Region	The preset parameter cannot be modified and is determined by Region in Execution Content.
     Target Instance	Set filter criteria in the filter box and select the displayed instances manually or automatically. CAUTION: If you select a job of ECS startup, ECS shutdown, or ECS restart, and select Select All for Selection Method, a maximum of 500 instances can be selected at a time. If more than 500 instances need to be selected, select Manual Selection for Selection Method.

     If you set a scheduled task for the job task type and want to use the suspension policy for the script task type, set corresponding parameters in the specific job step. For example, if you want to stop an ECS, set the successRate parameter.

     Figure 1 Setting the suspension policy for the job for periodically stopping ECSs.
     

8. (Optional) Set global parameters.

   Global parameters can be customized or obtained from the parameter center. Click Modify to modify the global parameters of the selected job. On the scheduled task page, you can only modify parameter values. To modify parameter names, go to the job management page or the parameter center.

9. Set Manual Review

   Table 7 Parameters for manual review

   Parameter	Description
   Manual Review	After this function is enabled, the task needs to be reviewed. For details about how to review, see Reviewing a Scheduled Task.
   Reviewer	Select Shift or Individual. Shift: Select a shift scenario and a role from the drop-down lists based on the configured values. For details about how to configure a shift, see Shift Schedule Management. Individual: Select a reviewer. For details about how to configure a reviewer, see Personnel Management.
   Notification Mode	Select a notification channel from the drop-down list. Default: The notification channel selected in the subscription notification settings of the reviewer is used by default. For details about how to set the default notification channel, see Selecting a Notification Method. SMS, WeCom, DingTalk, Lark, and Email: Notifications are sent based on the information reserved by the reviewer. For details about how to set the reviewer information, see Modifying Personnel Information. No notification: The system does not notify any recipient.

10. Enable Send Notification. This operation is optional.

    Table 8 Notification parameters

    Parameter	Description
    Send Notifications	Enable it and set Recipient and Notification Mode based on the selected notification policy.
    Notification Policy	Select Start of execution, Execution failed, or Execution succeeded. Multiple options can be selected.
    Recipient	Select Shift or Individual. Shift: Select a shift scenario and a role from the drop-down lists based on the configured values. For details about how to configure a shift, see Shift Schedule Management. Individual: Select a reviewer. For details about how to configure a reviewer, see Personnel Management.
    Notification Mode	Select a notification channel from the drop-down list. Default: The notification channel selected in the subscription notification settings of the reviewer is used by default. For details about how to set the default notification channel, see Selecting a Notification Method. SMS, WeCom, DingTalk, Lark, and Email: Notifications are sent based on the information reserved by the recipient. For details about how to set recipient information, see Modifying Personnel Information.

11. Click OK. The scheduled task is created.

    After the scheduled task is created, you can view its information in the scheduled task list, such as the schedule type, script/job name, number of executions, and status. You can also manage scheduled tasks based on service requirements.

    Wait until the task execution time arrives. The system automatically performs related operations.

Helpful Links

• When creating a scheduled task, check whether the parameters in the parameter center and those set on the target instances belong to different regions.
• To use a scheduled task to automatically restart ECSs, see Automatically Restarting an ECS at a Specified Time.
• Use COC scheduled ECS startup/shutdown to cut costs generated by idle ECSs during off-peak hours. For details, see Saving Costs Through Scheduled Startup and Shutdown on COC.
• Use COC to build a mechanism for automatically notification upon scheduled OS patch scanning failures. This mechanism enables real-time notification of failure incidents, quick root cause identification, and closed-loop issue resolution. For details, see Automatic Notification Upon Scheduled OS Patch Scanning Failures.
• COC enables you to create, enable, disable, modify, and delete scheduled tasks through API calls. For details, see Scheduled O&M.