立即执行命令 - 云服务器 ECS

通过立即执行命令，您可以同时创建命令和执行命令。

前提条件

实例的状态必须为运行中（Running）。
在一个阿里云地域下，您可以保存100条云助手命令，配额随您的云服务器使用情况可能会增加。关于如何查询配额，请参见步骤一：查看资源配额。在立即执行命令时，如果您只执行命令，则不占用云助手命令配额。

说明您也可以调用API DescribeAccountAttributes，将参数AttributeName.N设置为max-axt-command-count，查询一个地域中云助手命令配额。
在一个阿里云地域下，您每天最多能执行5000次云助手命令，配额随您的云服务器使用情况可能会增加。关于如何查询配额，请参见步骤一：查看资源配额。

说明您也可以调用API DescribeAccountAttributes，将参数AttributeName.N设置为max-axt-invocation-daily，查询一个地域下单天能运行的云助手命令次数上限。

背景信息

立即执行云助手命令时，您需要注意以下事项。

创建的脚本在Base64编码后大小不能超过16 KB。
一份云助手命令中的自定义参数不能超过20个。
调用API执行命令时最多可以选择50台实例。
创建命令时，您需要自行测试命令的语法、逻辑或算法是否正确。
例如，假设您已在实例中创建了一个/backup目录（mkdir /backup），以下Shell命令将在该目录中归档一份文件。
```
#!/bin/bash 
OF=/backup/my-backup-$(date +%Y%m%d).tgz
tar -cf $OF {{file}}
```
说明以上示例命令中，{{file}}是一个自定义参数，您可以在执行命令时设置为需要归档的目标文件，如/app/usrcredential。自定义参数能满足动态取值以及一值多用的场景。对于具有安全敏感性的数据以及随环境变化的数据，建议您设置自定义参数，例如AccessKey、实例ID、授权码、时间参数、关键系统文件等。

控制台操作

登录ECS管理控制台。
在左侧导航栏，选择运维与监控 > 发送命令/文件（云助手）。
在顶部菜单栏左上角处，选择地域。
单击创建/执行命令。

在命令信息区域，设置参数。


名称	描述
命令来源	选择命令来源。输入命令内容：创建一个新命令。选择已保存的命令：选择已创建的命令。
命令名称	设置命令名称。
执行计划	选择命令执行时间。立即执行：单击执行或执行并保存后，立即执行命令。系统下一次启动后：单击执行或执行并保存后，实例下次启动时执行命令。系统每次启动后：单击执行或执行并保存后，实例每次启动时执行命令。
命令类型	选择命令类型。 Linux：选择Shell。 Windows：选择Bat或者Power Shell。
命令内容	编辑或者粘贴您的命令。有关Shell命令的示例，请参见查看实例系统配置。
使用参数	选择是否启用参数。如果您开启了使用参数功能，在命令内容中以`{{key}}`格式设置自定义参数。
命令参数	设置命令内容中`{{key}}`自定义参数的取值。仅在开启了使用参数功能后可设置此参数。说明如果需要在云助手中使用运维编排服务的参数仓库，请参见在云助手命令中使用OOS参数仓库。
命令描述	设置命令的描述信息。建议设置命令用途等信息，方便后续管理维护。
执行用户	在ECS实例中执行命令的用户名称。使用最小权限执行命令是权限管理的最佳实践，建议您以普通用户身份执行云助手命令。更多信息，请参见设置普通用户执行云助手命令。默认情况下，在Linux实例中以root用户执行命令，在Windows实例中以System用户执行命令。
密码名称	选择托管在运维编排服务中的执行用户密码名称。仅在Windows实例中使用非System用户执行命令时，需要设置此参数。如果您没有将执行用户的密码托管在运维编排服务，需要在运维编排服务的参数仓库中创建并托管密码。更多信息，请参见创建加密参数和配置Windows实例的普通用户执行云助手命令。
执行路径	自定义命令的执行路径。默认路径如下： Linux：默认在root用户的/home目录。 Windows：默认在云助手客户端进程目录，例如，C:\ProgramData\aliyun\assist\$(version)。
超时时间	设置命令在实例中的超时时间，当执行命令的任务超时后，云助手将强制终止任务进程。单位为秒，默认为60秒，最小为10秒。如果您设置的超时时间小于10秒，为确保命令执行成功，会被系统设置为10秒。

在选择实例和选择托管实例区域，选中需要执行命令的目标实例。

说明托管实例是云助手托管的非阿里云服务器，更多信息，请参见混合云托管服务器。
单击执行并保存或执行。

CLI示例

请求示例：

调用RunCommand接口创建一个名为update的云助手命令，为实例进行系统更新。

aliyun ecs RunCommand --RegionId 'cn-hangzhou' \
--Name 'update' --Username 'root' --Type 'RunShellScript' \
--CommandContent 'eXVtIC15IHVwZGF0ZQ==' \
--Timeout '60' --RepeatMode 'Once' --ContentEncoding 'Base64' \
--InstanceId.1 'i-bp12e0ib2ztibede****'

说明半角单引号（''）内为参数的示例取值，您需要根据实际情况修改。


名称	示例	描述
RegionId	cn-hangzhou	地域ID。
Name	update	命令名称。
Username	root	在ECS实例中执行命令的用户名称。
Type	RunShellScript	命令类型。 Linux：RunShellScript Windows：RunBatScript或者RunPowershellScript
CommandContent	eXVtIHVwZGF0ZSAteQ==	通过Base64编码后的命令内容。
Timeout	60	超时时间。
RepeatMode	Once	执行计划。
ContentEncoding	Base64	编码方式。
InstanceId.1	i-bp12e0ib2ztibede****	需要执行命令的实例ID。

更多信息，请参见RunCommand。

返回示例：

{
        "CommandId": "c-hz018qlm868****",
        "InvokeId": "t-hz018qlm86d****",
        "RequestId": "1D24FA80-64DB-4842-AB20-25207994418F"
}