ModifyInvocationAttribute_云服务器 ECS_API调试-阿里云OpenAPI开发者门户

接口说明

支持修改以下执行方式的任务（参见 DescribeInvocations 返回的RepeatMode值）：
- Period：周期执行。
- NextRebootOnly：当实例下一次启动时，自动执行命令。
- EveryReboot：实例每一次启动都将自动执行命令。
支持修改以下状态的任务（参见 DescribeInvocations 返回的InvocationStatus值）：
- Pending：系统正在校验或发送命令。存在至少一台实例的命令执行状态为 Pending，则总执行状态为 Pending。
- Running：命令正在实例上运行。存在至少一台实例的命令执行状态为 Running，则总执行状态为 Running。
- Scheduled：定时执行的命令已发送，等待运行。存在至少一台实例的命令执行状态为 Scheduled，则总执行状态为 Scheduled。
- Stopping：正在停止任务。存在至少一台实例的命令执行状态为 Stopping，则总执行状态为 Stopping。
修改定时任务执行信息（包括命令内容、自定义参数、执行频率）前，已执行的 ECS 实例或托管实例的云助手 Agent 版本需要高于以下对应的版本。
- Linux：2.2.3.541
- Windows：2.1.3.541
- 如果调用结果返回InvalidOperation.CloudAssistantVersionUnsupported错误码，请将云助手 Agent 更新至最新版本。
当您执行一个云助手公共命令时，无法修改命令内容CommandContent。
当您修改了命令内容CommandContent，且调用 InvokeCommand 或调用 RunCommand 时设置KeepCommand为true创建任务，将会新增一条命令并长期保留，并占用云助手命令配额；在一个地域下，您最多可以保有 500～50,000 条云助手命令。您也可以申请提升配额，关于如何查询及提升配额，请参见配额管理。

请求参数

字段名称	字段详情
RegionIdstring	地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
InstanceIdarray<string>	待加入任务的 ECS 实例 ID 或托管实例 ID。子级条数 <= 201
InvokeIdstring	待修改任务的命令执行 ID。示例值:t-hz0jdfwd9f****参考取值来源: InvokeCommand
CommandContentstring	待修改后的命令内容。命令内容可以是明文内容或 Base64 编码后的内容。您需要注意：展开详情示例值:ZWNobyAxMjM=
EnableParameterboolean	修改命令中是否包含自定义参数。展开详情示例值:false
Parametersobject	命令中包含自定义参数时，修改执行命令时传入的自定义参数的键值对。展开详情示例值:{"name":"Jack", "accessKey":"LTAI*************"}
Frequencystring	待修改的定时执行频率。仅当`RepeatMode`为`Period`时生效。目前支持三种定时执行方式：固定时间间隔执行（基于 Rate 表达式）、仅在指定时间执行一次、基于时钟定时执行（基于 Cron 表达式）。展开详情示例值:0 /20 * * *
ContentEncodingstring	命令内容（`CommandContent`）的编码方式。取值范围（不区分大小写）：展开详情示例值:PlainText

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
CommandIdstring	命令 ID。展开详情示例值:c-hz01272yr52****

变更历史

	变更时间	变更内容概要	操作
	2024-12-05	变更错误码403
	2024-04-03	变更错误码403