全部产品
Search
文档中心

云服务器 ECS:修改云助手任务执行信息

更新时间:May 29, 2025

当已创建的任务不满足您的业务需求时,您可以根据需要修改任务的执行信息,包括命令内容、定时执行方式、添加ECS实例或托管实例到任务。本文介绍如何在云助手控制台修改任务执行信息。

使用限制

修改任务执行信息时,必须满足以下条件:

  • 仅支持执行计划为定时执行系统下一次启动后系统每次启动后执行的任务。

  • 仅支持修改以下执行状态的任务:

    • Pending:系统正在校验或发送命令。如果存在至少一台实例的命令执行状态为Pending,则总执行状态为Pending。

    • Running:命令正在实例上运行。只要存在至少一台实例的命令执行状态为Running,则总执行状态为Running。

    • Scheduled:定时执行的命令已发送,等待运行。存在至少一台实例的命令执行状态为Scheduled,则总执行状态为Scheduled。

    • Stopping:正在停止任务。存在至少一台实例的命令执行状态为 Stopping,则总执行状态为 Stopping。

  • 修改任务执行信息(包括命令内容、自定义参数、执行频率)前,已执行的ECS实例或托管实例必须满足以下条件:

    • 状态处于运行中(Running)。

    • 已安装云助手Agent。具体操作,请参见安装云助手Agent

    • 云助手Agent不低于以下版本(仅添加ECS实例或托管实例到任务时无此限制)。

      • Linux:2.2.3.541

      • Windows:2.1.3.541

        如果修改任务返回InvalidOperation.CloudAssistantVersionUnsupported错误码,请将云助手Agent更新至最新版本。具体操作,请参见升级、禁止自动升级云助手Agent

  • 添加ECS实例或托管实例到定时任务时,待加入的实例数量与已执行的实例数量总和不得超过100。

  • 当您修改了命令内容(CommandContent),且调用InvokeCommand或调用RunCommand时设置KeepCommandtrue创建任务,将会新增一条命令并长期保留,并占用云助手命令配额。

  • 在一个阿里云地域下,您可以保存500~50,000条云助手命令,配额随您的云服务器使用情况可能会增加。您也可以申请提升配额,关于如何查询及提升配额,请参见ECS配额管理

    说明

    填写详细的配额提升申请理由可提高审批通过率。

  • 当一个任务为云助手公共命令时,不支持修改命令内容(CommandContent)。

  • RAM用户修改任务执行信息时,需为RAM用户授予一定的权限。更多信息,请参见修改定时任务的执行信息

操作步骤

  1. 访问ECS控制台-云助手

  2. 在页面左侧顶部,选择目标资源所在的资源组和地域。地域

  3. 命令执行结果页签下,找到待修改任务,在操作栏中,单击修改执行信息

    image

  4. 修改执行信息面板中,修改执行参数。

    1. 命令内容相关参数。

      是否修改命令内容默认开启,您可以修改命令内容。

      使用参数默认关闭,开启后,您可以指定内置环境参数作为自定义参数,执行命令时无需手动对参数赋值,云助手将为您自动替换为环境中对应的值,例如实例ID、地域ID等。

    2. 选择定时执行方式,并设置定时执行参数。

      说明

      待修改的任务执行计划为系统下一次启动后系统每次启动后,无法选择定时执行方式。

      定时执行方式

      说明

      固定时间间隔执行(Rate表达式)

      设置的重复频率不大于7天、不小于60秒,且需要大于创建该任务时指定的超时时间。

      仅在指定时间执行一次

      设置执行时间及时区。

      基于时钟定时执行(Cron表达式)

      设置的重复频率需大于或等于创建定时任务时指定的超时时间,且不小于10秒。

    3. 选择实例选择托管实例区域,选择待加入任务的实例

  5. 单击修改

    修改完成后,任务将按照新修改的命令执行。

相关文档

您也可以通过调用API ModifyInvocationAttribute来修改任务执行信息。