如果當(dāng)前伸縮組的定時任務(wù)不能滿足業(yè)務(wù)需求,您可以調(diào)用ModifyScheduledTask接口,通過指定定時任務(wù)的ID修改已有定時任務(wù)的配置參數(shù):需要執(zhí)行的伸縮規(guī)則、伸縮組內(nèi)實例數(shù)量、任務(wù)執(zhí)行頻率、重試策略等。
接口說明
定時任務(wù)支持兩種伸縮方式:
- 通過
ScheduledAction
參數(shù)設(shè)置需要執(zhí)行的伸縮規(guī)則。 - 通過
ScalingGroupId
參數(shù)設(shè)置伸縮組內(nèi)實例數(shù)量。
ScheduledAction
和ScalingGroupId
。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
ess:ModifyScheduledTask | update | *全部資源 * |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ScheduledTaskId | string | 是 | 定時任務(wù)的 ID。 | edRtShc57WGXdt8TlPbr**** |
ScheduledTaskName | string | 否 | 定時任務(wù)的名稱。2-64 個字符,以大小寫字母、數(shù)字或中文開頭,可包含(.)、下劃線(_)或中劃線(-)。同一賬號同一地域內(nèi)唯一。 | scheduled**** |
Description | string | 否 | 定時任務(wù)的描述信息。2-200 個字符。 | Test scheduled task. |
ScheduledAction | string | 否 | 如果伸縮方式為選擇已有伸縮規(guī)則時,才會出現(xiàn)該配置項,請您選擇已創(chuàng)建的伸縮規(guī)則,填寫伸縮規(guī)則的唯一標(biāo)識符,可在伸縮規(guī)則詳情頁查看。 說明
不支持同時設(shè)置 ScheduledAction 和ScalingGroupId 。
| ari:acs:ess:cn-hangzhou:14069264****:scalingrule/asr-bp12tcnol686y1ik**** |
RecurrenceEndTime | string | 否 | 重復(fù)執(zhí)行定時任務(wù)的結(jié)束時間。按照 ISO8601 標(biāo)準(zhǔn)表示,并需要使用 UTC 時間。格式為:YYYY-MM-DDThh:mmZ。不能填寫自修改當(dāng)天起 365 日后的時間。 | 2014-08-20T16:55Z |
LaunchTime | string | 否 | 定時任務(wù)執(zhí)行的時間點。按照 ISO8601 標(biāo)準(zhǔn)表示,并需要使用 UTC 時間。格式為:YYYY-MM-DDThh:mmZ。不能填寫自修改當(dāng)天起 90 日后的時間。
| 2014-08-18T10:52Z |
RecurrenceType | string | 否 | 設(shè)置定時任務(wù)重復(fù)的周期類型,支持按日、周、月等周期性執(zhí)行。取值范圍:
修改后, | Daily |
RecurrenceValue | string | 否 | 定時任務(wù)重復(fù)執(zhí)行的周期類型對應(yīng)數(shù)值。
修改后, | 2 |
TaskEnabled | boolean | 否 | 是否啟動定時任務(wù)。取值范圍:
默認值:true。 | true |
LaunchExpirationTime | integer | 否 | 定時任務(wù)觸發(fā)操作失敗后,彈性伸縮將在重試過期時間內(nèi)繼續(xù)嘗試執(zhí)行定時任務(wù)。單位為秒,取值范圍:0~1800。 默認值:600。 | 600 |
MinValue | integer | 否 | 定時任務(wù)的伸縮方式為設(shè)置伸縮組內(nèi)實例數(shù)量時,指定伸縮組內(nèi)實例的最小數(shù)量。 | 0 |
MaxValue | integer | 否 | 定時任務(wù)的伸縮方式為設(shè)置伸縮組內(nèi)實例數(shù)量時,指定伸縮組內(nèi)實例的最大數(shù)量。 | 10 |
DesiredCapacity | integer | 否 | 定時任務(wù)的伸縮方式為設(shè)置伸縮組內(nèi)實例數(shù)量時,指定伸縮組內(nèi)實例的期望實例數(shù)。 說明
伸縮組必須支持設(shè)置期望實例數(shù),即在創(chuàng)建該伸縮組時指定了 DesiredCapacity 。
| 10 |
ScalingGroupId | string | 否 | 如果伸縮方式為設(shè)置伸縮組內(nèi)實例數(shù)量,才會出現(xiàn)該配置項,請您填寫定時任務(wù)觸發(fā)時需要修改實例數(shù)量的伸縮組 ID。指定 說明
不支持同時設(shè)置 ScheduledAction 和ScalingGroupId 。
| asg-bp18p2yfxow2dloq**** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 |
---|---|---|
400 | Throttling | Request was denied due to request throttling. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|