创建云助手命令后,您可以在一台或者多台ECS实例中执行命令。多台实例间的执行状态和执行结果互相不影响。
前提条件
执行云助手命令前,目标ECS实例必须满足以下条件:- 状态处于运行中(
Running
)。 - 已安装云助手Agent。具体操作,请参见安装云助手Agent。使用定时任务的新特性(固定时间间隔执行、仅在指定时间执行一次、基于Cron表达式定时执行时指定年份或时区)时,需确保云助手Agent不低于以下版本:
- Linux:2.2.3.282
- Windows:2.1.3.282
如果执行定时任务结果返回
ClientNeedUpgrade
错误码,请将客户端更新至最新版本。具体操作,请参见升级或禁止升级云助手Agent。
背景信息
- 调用API执行命令时最多可以选择50台实例。
- 通过ECS管理控制台一次执行命令操作的实例数量大于50台时,系统会自动分批执行命令。
控制台操作
- 登录ECS管理控制台。
- 在左侧导航栏,选择 。
- 在顶部菜单栏左上角处,选择地域。
- 在命令列表页签找到目标云助手命令,在右侧操作列中,单击执行。
- 在执行命令对话框中,配置执行参数。
- 单击执行。
CLI示例
- 可选:检查实例状态,若实例的状态不是运行中(
Running
),调用StartInstance接口启动目标实例。aliyun ecs StartInstance --InstanceId 'i-bp1f4f6o8lv0wqof****'
说明 半角单引号('')内为参数的示例取值,您需要根据实际情况修改。更多信息,请参见StartInstance。
- 可选:调用DescribeCloudAssistantStatus接口查询目标实例是否安装了云助手Agent。
aliyun ecs DescribeCloudAssistantStatus --RegionId 'cn-hangzhou' \ --InstanceId.1 'i-bp1f4f6o8lv0wqof****'
返回CloudAssistantStatus=true
结果时,表示实例已安装云助手Agent。否则,请调用InstallCloudAssistant接口为实例安装客户端。更多信息,请参见DescribeCloudAssistantStatus和InstallCloudAssistant。 - 调用InvokeCommand接口为一台或多台实例执行已创建的云助手命令。
aliyun ecs InvokeCommand --RegionId 'cn-hangzhou' \ --InstanceId.1 'i-bp1f4f6o8lv0wqof****' \ --InstanceId.2 'i-bp137qu6142s3mhm****' \ --CommandId 'c-hz018qp243j****' \ --Timed 'false'
名称 示例 描述 RegionId cn-hangzhou 地域ID。 InstanceId.1 i-bp1f4f6o8lv0wqof**** 执行命令的第一个实例ID。 InstanceId.2 i-bp137qu6142s3mhm**** 执行命令的第二个实例ID。 CommandId c-hz018qp243j**** 命令ID。 Timed false 命令是否为定时执行。 如果需要设置定时执行,Timed设置为true,且Frequency参数指定执行时间。目前支持三种定时执行方式:固定时间间隔执行(基于Rate表达式)、仅在指定时间执行一次、基于时钟定时执行(基于Cron表达式)。例如您指定了Cron表达式:0 */20 * * * ?,表示每20分钟执行一次命令。 更多信息,请参见Cron表达式。
更多信息,请参见InvokeCommand。