執(zhí)行伸縮規(guī)則可以實(shí)現(xiàn)手動(dòng)或自動(dòng)調(diào)整ECS實(shí)例或ECI實(shí)例資源。其中,對(duì)于簡單規(guī)則和步進(jìn)規(guī)則,您才可以調(diào)用API ExecuteScalingRule執(zhí)行一條伸縮規(guī)則,而對(duì)于目標(biāo)追蹤規(guī)則和預(yù)測(cè)規(guī)則,彈性伸縮會(huì)自動(dòng)執(zhí)行伸縮規(guī)則。
接口說明
調(diào)用該接口前請(qǐng)確保滿足以下條件:
- 伸縮組處于 Active 狀態(tài)。
- 伸縮組沒有執(zhí)行中的伸縮活動(dòng)。
當(dāng)伸縮組沒有執(zhí)行中的伸縮活動(dòng)時(shí),該接口可以繞過冷卻時(shí)間(Cooldown)直接執(zhí)行伸縮活動(dòng)。
調(diào)用該接口返回成功,只是表示彈性伸縮服務(wù)接受了該接口的調(diào)用請(qǐng)求,可以執(zhí)行伸縮活動(dòng),但不代表伸縮活動(dòng)能夠執(zhí)行成功。您需要通過返回的 ScalingActivityId 查看該伸縮活動(dòng)的執(zhí)行狀態(tài)。
如果伸縮規(guī)則需要增加的 ECS 實(shí)例數(shù)加上當(dāng)前伸縮組的實(shí)例數(shù)(Total Capacity)大于 MaxSize,則按 Total Capacity = MaxSize 執(zhí)行伸縮活動(dòng)。
如果當(dāng)前伸縮組的實(shí)例數(shù)(Total Capacity)減去伸縮規(guī)則需要減少的 ECS 實(shí)例數(shù)小于 MinSize,則按 Total Capacity = MinSize 執(zhí)行伸縮活動(dòng)。
單次調(diào)整的 ECS 實(shí)例臺(tái)數(shù)存在限制,請(qǐng)參見 CreateScalingRule 中的 AdjustmentValue 參數(shù)說明。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別:是指每個(gè)操作的訪問級(jí)別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
ess:ExecuteScalingRule | update | *ScalingGroup acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId} |
| 無 |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ScalingRuleAri | string | 是 | 伸縮規(guī)則唯一標(biāo)識(shí)符。 說明
調(diào)用 API 執(zhí)行伸縮規(guī)則時(shí),只支持執(zhí)行簡單規(guī)則和步進(jìn)規(guī)則,且執(zhí)行步進(jìn)規(guī)則時(shí)必須同時(shí)指定 BreachThreshold 和MetricValue 。
| ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7**** |
ClientToken | string | 否 | 用于保證請(qǐng)求的冪等性。 由客戶端生成該參數(shù)值,要保證在不同請(qǐng)求間唯一,最大不超過 64 個(gè) ASCII 字符。詳情請(qǐng)參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
BreachThreshold | float | 否 | 執(zhí)行步進(jìn)伸縮規(guī)則時(shí)指定的當(dāng)前閾值,取值范圍:-9.999999E18~9.999999E18。 | 1.0 |
MetricValue | float | 否 | 執(zhí)行步進(jìn)伸縮規(guī)則時(shí)指定的當(dāng)前指標(biāo)值,取值范圍:-9.999999E18~9.999999E18。 | 1.0 |
RegionId | string | 否 | 伸縮組所屬地域的 ID。 | cn-qingdao |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"ScalingActivityId": "asa-bp13o672yeautiil****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|