ModifyScheduledTask
调用ModifyScheduledTask接口修改一个定时任务的属性。
调试
前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| ScheduledTaskId | String | 是 | edRtShc57WGXdt8TlPbr**** |
定时任务的ID。 |
| Action | String | 否 | ModifyScheduledTask |
操作接口名，系统规定参数，取值：ModifyScheduledTask。 |
| ScheduledTaskName | String | 否 | scheduled**** |
定时任务的显示名称。2~64个英文或中文字符，以数字、大小字母或中文开头，可包含数字、下划线（_）、连词符（-）或英文句号（.）。 同一账号同一地域内唯一。 |
| Description | String | 否 | fortest |
定时任务的描述信息。2~200个英文或中文字符。 |
| ScheduledAction | String | 否 | ari:acs:ess:cn-qingdao:1344371:scalingRule/cCBpdYdQuBe2cUxOdu6**** |
定时任务触发时需要执行的操作，填写伸缩规则的唯一标识符。 |
| LaunchTime | String | 否 | 2014-08-18T10:52Z |
定时任务触发的时间点。 按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。不能填写自修改当天起90日后的时间。 如果指定了RecurrenceType，则此属性指定的时间点，默认为循环执行的时间点。 如果未指定RecurrenceType，则按指定的日期和时间执行一次。 |
| RecurrenceType | String | 否 | Daily |
重复执行定时任务的类型。可选值：
修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
| RecurrenceValue | String | 否 | 2 |
重复执行定时任务的数值。
修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
| RecurrenceEndTime | String | 否 | 2014-08-20T16:55Z |
重复执行定时任务的结束时间。按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。不能填写自修改当天起365日后的时间。 修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
| TaskEnabled | Boolean | 否 | true |
是否启动定时任务。
|
| LaunchExpirationTime | Integer | 否 | 600 |
定时任务触发操作失败后，在此时间内重试。单位为秒，取值范围：0~21600。 |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
请求ID。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=ModifyScheduledTask
&ScheduledTaskId=edRtShc57WGXdt8TlPbr****
&LaunchTime=2014-08-18T10:52Z
&RecurrenceEndTime=2014-08-20T16:55Z
&<公共请求参数>
正常返回示例
XML 格式
<ModifyScheduledTaskResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScheduledTaskResponse>
JSON 格式
{
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}错误码
HttpCode |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
|
404 |
InvalidScheduledTaskId.NotFound |
The specified scheduled task does not exist. |
指定的定时任务在该用户账号下不存在。 |
|
400 |
InvalidScheduledTaskName.Duplicate |
The specified value of parameter
is duplicated. |
定时任务名已存在。 |
|
400 |
ScheduledAction.RegionMismatch |
The specified scheduled task and the specified scheduled action are not in the same |
指定的ScheduledAction与定时任务所在的地域不匹配。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4554.html
微信扫一扫
相关推荐
-
返回结果
本文主要介绍返回结果。 返回结果主要有 XML 和 JSON 两种格式，默认为 JSON，您可以指定公共请求参数 Format 变更返回结果的格式。更多详情，请参阅 。 说明 为了便于查看和美观，API 文档返回示例均有换行和缩进等处理，实际返回结果无换行和缩进处理。 正常返回示…
-
阿里云弹性伸缩怎么自动将伸缩组ECS实例添加到Redis实例白名单？
本文介绍如何使用弹性伸缩、消息服务和函数计算，将弹性扩张时创建的ECS实例自动添加到Redis实例的白名单。您可以作为参考，实现更多自动化操作。 背景信息 目前，弹性伸缩已经接入负载均衡、云数据库RDS等产品，但是暂未接入云数据库Redis。如果您将业务数据存储在Redis实例上…
-
DeleteScalingGroup
本文介绍删除伸缩组API操作。 描述 删除一个指定的伸缩组。 ForceDelete属性表示如果伸缩组存在ECS实例或正在进行伸缩活动，是否强制删除伸缩组并移出和释放ECS实例。 如果ForceDelete属性为false，必须满足以下两个条件，才能删除伸缩组： 条件一：伸缩组没…
-
RemoveInstances
从指定的伸缩组里移出 ECS 实例。 描述 从伸缩组移出弹性伸缩自动创建的 ECS 实例时，ECS 实例进入停机不收费状态或者被释放。 从伸缩组移出用户手工加入的 ECS 实例时，不停止和释放该 ECS 实例。 当伸缩组为 Active 状态，才可以调用该接口。 当伸缩组没有伸缩…
-
DescribeScalingRules
查询伸缩组下的伸缩规则，并列出伸缩规则的属性。 描述 您可以通过指定伸缩组ID来查询该伸缩组下的所有伸缩规则，查询时可以输入伸缩规则ID、伸缩规则名称、伸缩规则唯一标识符、伸缩规则类型进行过滤。 请求参数 名称 类型 是否必选 描述 Action String 是 操作接口名，系…
-
事件通知概述
事件通知是一种监控手段，可以自动发送消息至云监控或消息服务，帮助您及时掌握伸缩组的动态，进一步实现自动化管理。 事件通知方式 事件通知支持发送消息到云监控系统事件、MNS主题或MNS队列。 云监控提供了各类云产品系统事件的统计和查询入口，包括弹性伸缩，您可以通过云监控及时了解伸缩…
