What is the cloud assistant?

The cloud assistant is a tool that provides native O&M and deployment services in Alibaba Cloud ECS. This tool supports visualized consoles and API actions. With the cloud assistant, you can run Bat, PowerShell, or Shell commands in batches without the need to connect to any instance. For more information, see Cloud assistant overview.

How do I use the cloud assistant?

You can use the cloud assistant through the ECS console or by calling the CreateCommand API action.

Which operating systems does the cloud assistant support?

The cloud assistant supports the following operating systems:

  • Windows operating systems: Windows Server 2008/2012/2016
  • Unix-like operating systems: Ubuntu 12/14/16, CentOS 5/6/7, Debian 7/8/9, RedHat 5/6/7, SUSE Linux Enterprise Server 11/12, OpenSUSE, Aliyun Linux, and CoreOS
  • By default, the cloud assistant client is installed on instances that are created by using ECS public images.
  • For instances created by using custom images or Alibaba Cloud Marketplace images, you need to first verify that the operating system on these instances supports the cloud assistant, and then configure the cloud assistant client.

How many cloud assistant commands can I have in an Alibaba Cloud region?

You can have up to 100 cloud assistant commands in an Alibaba Cloud region.

Can I modify a cloud assistant command that I created?

You can modify the name and description of a command, but you cannot modify other information, such as the script content, expiration time, and execution path.

If you want to modify the script content or execution path, you can clone the command. For more information, see Clone a command.

Do I need any privileges to run cloud assistant commands on ECS instances?

Yes, you can only install and use the cloud assistant client as an administrator or the root user.

  • To run commands on Windows instances, you must have administrator privileges.
  • To run commands on Linux instances, you must have root privileges.

Can I run a cloud assistant command on multiple instances at the same time?

Yes, you can run a cloud assistant command on up to 50 instances at a time. Additionally, you can run cloud assistant commands up to 5000 times a day in an Alibaba Cloud region.

How can I check whether I successfully run a command?

You can successfully run a command only when all command conditions are satisfied, regardless of whether you run a command on the cloud assistant client or on an ECS instance. You can use either of the following methods to check the command result:

  • Log on to the ECS console to view the command result.
  • Call the DescribeInvocationResults API action.
  • Connect to the instance to view the log file:
    • Windows instance: C:\ProgramData\aliyun\assist\${version}\log\aliyun_assist_main.log
    • Linux instance: /usr/local/share/aliyun-assist/${version}/log/aliyun_assist_main.log

      The variable ${version} is the version number of the cloud assistant client on the target instance, for example,