InvokeCommand_云服务器 ECS_API调试

接口说明

• 对目标 ECS 实例有如下限制。选择了多台 ECS 实例后，若其中某台实例不满足执行条件，您需要重新调用接口。

  • 状态必须为运行中（Running），您可以调用 DescribeInstances 查询。

  • 已预先安装云助手 Agent。

  • 执行类型为 PowerShell 的命令时，实例必须已经配置了 PowerShell 模块。

• 单次执行：只执行一次命令。

• 定时执行：

  • 根据参数 Frequency 指定的时间频率定时执行，上次的执行结果不会对下一次执行产生任何影响。
  • 当您基于 Cron 表达式执行定时任务且指定了时区，时钟定时执行时间设置基准为您指定的时区；当您没有指定时区时，时钟定时执行时间设置基准为 ECS 实例内的系统时区，且执行时间以实例的系统时间为准。请确保 ECS 实例的时间或者时区与您预期的时间一致。更多关于时区的详情，请参见管理时间同步服务。

  云助手 Agent 版本不低于以下对应的版本才能支持定时任务的新特性（固定时间间隔执行、仅在指定时间执行一次、基于 Cron 表达式定时执行时指定年份或时区）。如果结果返回 ClientNeedUpgrade 错误码，请参见升级或禁止升级云助手 Agent，将客户端更新至最新版本。

  • Linux：2.2.3.282。
  • Windows：2.1.3.282。

• 命令可能会因为目标实例的状态异常、网络异常或云助手 Agent 异常而出现无法执行的情况，无法执行时不会生成执行信息。更多信息，请参见执行失败常见错误及修复建议。

• 当您创建命令时启用了自定义参数功能，需要在执行命令时传入自定义参数（Parameters）。

• 建议您先调用 DescribeCloudAssistantStatus 查询实例的云助手状态，当 CloudAssistantStatus 为 true 时再执行命令，尤其对于新购实例。