After creating cloud assistant commands, you can run commands on one or more instances. The command execution status and results for each instance are not influenced by the same command being run on other instances, for individual instances are not influenced by identical commands being run on other instances.

Prerequisites

  • The instance must be in the running (Running) state.
  • The Cloud assistant client must be installed on the instance.
  • The instance must be a VPC-type instance.

Background information

  • In an Alibaba Cloud region, you can run a maximum of 5,000 cloud assistant commands in a single day. The quantity of cloud assistant commands may increase with your ECS usage.
    Note You can also call DescribeAccountAttributes, with the AttributeName.N parameter set to max-axt-invocation-daily, to query the maximum number of cloud assistant commands that can be run daily in a region.
  • A single command can be run on a maximum of 50 instances at a time.
  • The interval for periodic cloud assistant commands cannot be less than 10 seconds.
  • The scheduled time for periodic command execution is set to UTC based on the system time obtained from the ECS instances. Make sure that the time and time zone of your ECS instances is configured correctly.

This topic describes how to run commands in the ECS console. You can also call InvokeCommand to perform the operation.

Procedure

  1. Log on to the ECS console.
  2. In the left-side navigation pane, choose Maintenance & Monitoring > Cloud Assistant.
  3. In the top navigation bar, select a region.
  4. Locate the command that you want to run and click Create Task in the Actions column.
  5. In the Create Task dialog box, configure the execution parameters.
    1. Click View to check the command content..

      If the command content is not correct, you can re-create the command before running it.

    2. Click Select. In the Select ECS Instances dialog box:
      1. Select one or more instances.
      2. Click to select them.
        Note For Bat or PowerShell commands, you must select Windows instances. For Shell commands, you must select Linux instances. All instances must have the cloud assistant client installed, or else the instance cannot be selected even after you click the icon.
      3. Click OK.
    3. In the Parameters box, enter the values of the custom parameters specified in the command.
      Note
      • If you do not select Use Parameters when you Create commands, the Parameters box will not be displayed.
      • There are no data type restrictions for custom parameters. If the current API call does not require values for the custom parameters, you can enter empty strings.
    4. Select Immediate One-Time Task or Recurring Task.
      • Immediate One-Time Task: The cloud assistant will run the command on the instances once immediately.
      • Recurring Task: Use a cron expression to define the period that the command recurs at. Fill in the Task Recurrence value. For more information, see Cron expressionsCron expressions.


  6. Click Create Task.

What to do next

Query execution results and statuses