如果當前伸縮組的定時任務不能滿足業務需求,您可以調用ModifyScheduledTask接口,通過指定定時任務的ID修改已有定時任務的配置參數:需要執行的伸縮規則、伸縮組內實例數量、任務執行頻率、重試策略等。
接口說明
定時任務支持兩種伸縮方式:
- 通過
ScheduledAction
參數設置需要執行的伸縮規則。 - 通過
ScalingGroupId
參數設置伸縮組內實例數量。
ScheduledAction
和ScalingGroupId
。調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ModifyScheduledTask | 系統規定參數。取值:ModifyScheduledTask。 |
ScheduledTaskId | String | 是 | edRtShc57WGXdt8TlPbr**** | 定時任務的ID。 |
ScheduledTaskName | String | 否 | scheduled**** | 定時任務的名稱。2-64個字符,以大小寫字母、數字或中文開頭,可包含(.)、下劃線(_)或中劃線(-)。同一賬號同一地域內唯一。 |
Description | String | 否 | Test scheduled task. | 定時任務的描述信息。2-200個字符。 |
ScheduledAction | String | 否 | ari:acs:ess:cn-hangzhou:14069264****:scalingrule/asr-bp12tcnol686y1ik**** | 如果伸縮方式為選擇已有伸縮規則時,才會出現該配置項,請您選擇已創建的伸縮規則,填寫伸縮規則的唯一標識符,可在伸縮規則詳情頁查看。 說明 不支持同時設置 ScheduledAction 和ScalingGroupId 。 |
RecurrenceEndTime | String | 否 | 2014-08-20T16:55Z | 重復執行定時任務的結束時間。按照ISO8601標準表示,并需要使用UTC時間。格式為:YYYY-MM-DDThh:mmZ。不能填寫自修改當天起365日后的時間。 |
LaunchTime | String | 否 | 2014-08-18T10:52Z | 定時任務執行的時間點。按照ISO8601標準表示,并需要使用UTC時間。格式為:YYYY-MM-DDThh:mmZ。不能填寫自修改當天起90日后的時間。
|
RecurrenceType | String | 否 | Daily | 定時任務重復執行的周期類型,支持按日、周、月等周期性執行。取值范圍:
修改后, |
RecurrenceValue | String | 否 | 2 | 定時任務重復執行的周期類型對應數值。
修改后, |
TaskEnabled | Boolean | 否 | true | 是否啟動定時任務。取值范圍:
默認值:true。 |
LaunchExpirationTime | Integer | 否 | 600 | 定時任務觸發操作失敗后,彈性伸縮將在重試過期時間內繼續嘗試執行定時任務。單位為秒,取值范圍:0~1800。 默認值:600。 |
MinValue | Integer | 否 | 0 | 定時任務的伸縮方式為設置伸縮組內實例數量時,指定伸縮組內實例的最小數量。 |
MaxValue | Integer | 否 | 10 | 定時任務的伸縮方式為設置伸縮組內實例數量時,指定伸縮組內實例的最大數量。 |
DesiredCapacity | Integer | 否 | 10 | 定時任務的伸縮方式為設置伸縮組內實例數量時,指定伸縮組內實例的期望實例數。 說明 伸縮組必須支持設置期望實例數,即在創建該伸縮組時指定了 DesiredCapacity 。 |
ScalingGroupId | String | 否 | asg-bp18p2yfxow2dloq**** | 如果伸縮方式為設置伸縮組內實例數量,才會出現該配置項,請您填寫定時任務觸發時需要修改實例數量的伸縮組ID。指定 說明 不支持同時設置 ScheduledAction 和ScalingGroupId 。 |
RegionId | String | 否 | cn-hangzhou | 伸縮組所屬的地域ID。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 請求ID。 |
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=ModifyScheduledTask
&ScheduledTaskId=edRtShc57WGXdt8TlPbr****
&ScheduledTaskName=scheduled****
&Description=Test scheduled task.
&ScheduledAction=ari:acs:ess:cn-hangzhou:14069264****:scalingrule/asr-bp12tcnol686y1ik****
&RecurrenceEndTime=2014-08-20T16:55Z
&LaunchTime=2014-08-18T10:52Z
&RecurrenceType=Daily
&RecurrenceValue=2
&TaskEnabled=true
&LaunchExpirationTime=600
&MinValue=0
&MaxValue=10
&DesiredCapacity=10
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&RegionId=cn-hangzhou
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyScheduledTaskResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScheduledTaskResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/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 ScheduledTaskName is duplicated. |
定時任務名已存在。 |
400 |
ScheduledAction.RegionMismatch |
The specified scheduled task and the specified scheduled action are not in the same Region. |
指定的ScheduledAction與定時任務所在的地域不匹配。 |