如果伸縮組處于停用狀態(tài),并且該伸縮組已通過指定啟動(dòng)模板方式或者創(chuàng)建并啟用伸縮配置方式指定了實(shí)例配置來源,您可以調(diào)用API EnableScalingGroup啟用一個(gè)伸縮組,通過彈性伸縮來自動(dòng)調(diào)整您的業(yè)務(wù)計(jì)算能力(即實(shí)例數(shù)量)。
接口說明
-
當(dāng)伸縮組處于 Inactive 狀態(tài),且伸縮組配置了組內(nèi)實(shí)例的配置信息來源(伸縮配置、啟動(dòng)模板或者在創(chuàng)建伸縮組時(shí)指定的 ECS 實(shí)例)時(shí),才可以調(diào)用該接口來啟用伸縮組。否則,會(huì)調(diào)用失敗。
說明 一個(gè)伸縮組在同一時(shí)刻有且只有一個(gè)生效的實(shí)例配置信息來源。在調(diào)用接口時(shí),您可以為伸縮組指定伸縮配置或啟動(dòng)模板。如果調(diào)用該接口前您已經(jīng)為伸縮組配置了實(shí)例配置信息來源,在調(diào)用時(shí)再指定伸縮配置或啟動(dòng)模板會(huì)覆蓋原有的配置信息。 -
當(dāng)該接口指定了加入伸縮組的 ECS 實(shí)例(InstanceId.N),調(diào)用該接口后,彈性伸縮會(huì)判斷在加入 ECS 實(shí)例后伸縮組的 ECS 實(shí)例數(shù)量(Total Capacity)是否在最小值(MinSize)和最大值(MaxSize)之間:
-
如果伸縮組的 Total Capacity 小于 MinSize,調(diào)用成功后,彈性伸縮服務(wù)會(huì)自動(dòng)創(chuàng)建差額的按量付費(fèi)的 ECS 實(shí)例。例如:創(chuàng)建伸縮組時(shí),指定 MinSize 為 5,在啟用伸縮組的 InstanceId.N 參數(shù)中指定 2 臺(tái)已有 ECS 實(shí)例,則彈性伸縮在加入 2 臺(tái)已有 ECS 實(shí)例之后,再自動(dòng)創(chuàng)建 3 臺(tái) ECS 實(shí)例。
-
如果伸縮組的 Total Capacity 大于 MaxSize,則調(diào)用失敗。
-
調(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)、讀取(Read)或列出(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:EnableScalingGroup | update | *全部資源 * |
| 無 |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ScalingGroupId | string | 是 | 伸縮組的 ID。 | asg-bp14wlu85wrpchm0**** |
ActiveScalingConfigurationId | string | 否 | 需要在伸縮組內(nèi)啟用的伸縮配置的 ID。 | asc-bp1ffogfdauy0nu5**** |
LaunchTemplateId | string | 否 | 實(shí)例啟動(dòng)模板的 ID,用于指定伸縮組從實(shí)例啟動(dòng)模板獲取啟動(dòng)配置信息。 | lt-m5e3ofjr1zn1aw7**** |
LaunchTemplateVersion | string | 否 | 實(shí)例啟動(dòng)模板的版本。取值范圍:
| Default |
InstanceIds | array | 否 | 啟用伸縮組后需要加入伸縮組的 ECS 實(shí)例的 ID。 指定加入伸縮組的 ECS 實(shí)例需要滿足以下條件:
| |
string | 否 | 啟用伸縮組后需要加入伸縮組的 ECS 實(shí)例的 ID。 指定加入伸縮組的 ECS 實(shí)例需要滿足以下條件:
| i-283vv**** | |
LoadBalancerWeights | array | 否 | 加入伸縮組中 ECS 實(shí)例或 ECI 實(shí)例作為后端服務(wù)器的權(quán)重。 默認(rèn)值:50。 | |
integer | 否 | 加入伸縮組中 ECS 實(shí)例或 ECI 實(shí)例作為后端服務(wù)器的權(quán)重。 默認(rèn)值:50。 | 50 | |
LaunchTemplateOverrides | array<object> | 否 | 擴(kuò)展啟動(dòng)模板的實(shí)例規(guī)格信息。 | |
object | 否 | 擴(kuò)展啟動(dòng)模板的實(shí)例規(guī)格信息。 | ||
InstanceType | string | 否 | 當(dāng)您需要伸縮組按照實(shí)例規(guī)格容量進(jìn)行伸縮時(shí),請(qǐng)同時(shí)指定本參數(shù)和 本參數(shù)用于指定實(shí)例規(guī)格,會(huì)覆蓋啟動(dòng)模板中的實(shí)例規(guī)格。 說明
僅當(dāng) LaunchTemplateId 參數(shù)指定了啟動(dòng)模板時(shí),本參數(shù)生效。
InstanceType 的取值范圍:在售的 ECS 實(shí)例規(guī)格。 | ecs.c5.xlarge |
WeightedCapacity | integer | 否 | 當(dāng)您需要伸縮組按照實(shí)例規(guī)格容量進(jìn)行伸縮時(shí),指定 本參數(shù)用于指定實(shí)例規(guī)格的權(quán)重,即實(shí)例規(guī)格的單臺(tái)實(shí)例在伸縮組中表示的容量大小。權(quán)重越大,滿足期望容量所需的本實(shí)例規(guī)格的實(shí)例數(shù)量越少。 由于每個(gè)實(shí)例規(guī)格的 vCPU 個(gè)數(shù)、內(nèi)存大小等性能指標(biāo)會(huì)有差異,您可以根據(jù)自身需求,給不同的實(shí)例規(guī)格配置不同的權(quán)重。 例如:
為滿足期望容量,伸縮組將為用戶擴(kuò)容 2 臺(tái) ecs.c5.xlarge 實(shí)例。 說明
擴(kuò)容時(shí)伸縮組的容量不得超過最大容量(MaxSize)與實(shí)例規(guī)格的最大權(quán)重之和。
WeightedCapacity 的取值范圍:1~500。 | 4 |
RegionId | string | 否 | 伸縮組所屬的地域 ID。 | cn-qingdao |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|