Modifies the information of a scheduled task.
Operation description
Operation description
Scheduled tasks support the following two scaling methods:
Use the
ScheduledActionparameter to specify the scaling rule to be executed.Use the
ScalingGroupIdparameter to specify the number of instances in the scaling group.
You cannot specify both ScheduledAction and ScalingGroupId at the same time.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ess:ModifyScheduledTask |
update |
*ScalingGroup
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ScheduledTaskId |
string |
Yes |
The ID of the scheduled task. |
edRtShc57WGXdt8TlPbr**** |
| ScheduledTaskName |
string |
No |
The name of the scheduled task. The name must be 2 to 64 characters in length, and can contain periods (.), underscores (_), and hyphens (-). It must start with a letter, digit, or Chinese character. The name must be unique within the same region and Alibaba Cloud account. |
scheduled**** |
| Description |
string |
No |
The description of the scheduled task. The description must be 2 to 200 characters in length. |
Test scheduled task. |
| ScheduledAction |
string |
No |
The unique identifier of the scaling rule. This parameter is available only when the scaling method is set to executing an existing scaling rule. Select an existing scaling rule and enter its unique identifier. You can view the identifier on the details page of the scaling rule. Note
You cannot specify both |
ari:acs:ess:cn-hangzhou:14069264****:scalingrule/asr-bp12tcnol686y1ik**** |
| RecurrenceEndTime |
string |
No |
The end time of the recurrence for the scheduled task. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mmZ format. The time must be in UTC. You cannot specify a time that is later than 365 days from the date of modification. |
2014-08-20T16:55Z |
| LaunchTime |
string |
No |
The time at which the scheduled task is executed. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mmZ format. The time must be in UTC. You cannot specify a time that is later than 90 days from the date of modification.
|
2014-08-18T10:52Z |
| RecurrenceType |
string |
No |
The recurrence type of the scheduled task. The task can be executed on a daily, weekly, or monthly basis. Valid values:
After the modification, both |
Daily |
| RecurrenceValue |
string |
No |
The recurrence value of the scheduled task, which corresponds to the recurrence type.
After the modification, both |
2 |
| TaskEnabled |
boolean |
No |
Specifies whether to enable the scheduled task. Valid values:
Default value: true. |
true |
| LaunchExpirationTime |
integer |
No |
The period of time during which Auto Scaling retries to execute the scheduled task after the task fails to be triggered. Unit: seconds. Valid values: 0 to 1800. Default value: 600. |
600 |
| MinValue |
integer |
No |
The minimum number of instances in the scaling group. This parameter is available only when the scaling method of the scheduled task is set to specifying the number of instances in the scaling group. |
0 |
| MaxValue |
integer |
No |
The maximum number of instances in the scaling group. This parameter is available only when the scaling method of the scheduled task is set to specifying the number of instances in the scaling group. |
10 |
| DesiredCapacity |
integer |
No |
The expected number of instances in the scaling group. This parameter is available only when the scaling method of the scheduled task is set to specifying the number of instances in the scaling group. Note
The scaling group must support the expected number of instances. That is, |
10 |
| ScalingGroupId |
string |
No |
The ID of the scaling group for which you want to modify the number of instances when the scheduled task is triggered. This parameter is available only when the scaling method is set to specifying the number of instances in the scaling group. After you specify Note
You cannot specify both |
asg-bp18p2yfxow2dloq**** |
| RegionId |
string |
No |
The region ID of the scaling group. |
cn-hangzhou |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
Examples
Success response
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Throttling | Request was denied due to request throttling. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.