EnableScalingGroup - 啟用一個伸縮組 - Auto Scaling

如果伸縮組處於停用狀態，並且該伸縮組已通過指定啟動模板方式或者建立並啟用伸縮配置方式指定了執行個體配置來源，您可以調用API EnableScalingGroup啟用一個伸縮組，通過Auto Scaling來自動調整您的業務計算能力（即執行個體數量）。

介面說明

當伸縮組處於 Inactive 狀態，且伸縮組配置了組內執行個體的配置資訊來源（伸縮配置、啟動模板或者在建立伸縮組時指定的 ECS 執行個體）時，才可以調用該介面來啟用伸縮組。否則，會調用失敗。

說明
一個伸縮組在同一時刻有且只有一個生效的執行個體配置資訊來源。在調用介面時，您可以為伸縮組指定伸縮配置或啟動模板。如果調用該介面前您已經為伸縮組配置了執行個體配置資訊來源，在調用時再指定伸縮配置或啟動模板會覆蓋原有的配置資訊。
當該介面指定了加入伸縮組的 ECS 執行個體（InstanceId.N），調用該介面後，Auto Scaling會判斷在加入 ECS 執行個體後伸縮組的 ECS 執行個體數量（Total Capacity）是否在最小值（MinSize）和最大值（MaxSize）之間：
- 如果伸縮組的 Total Capacity 小於 MinSize，調用成功後，Auto Scaling服務會自動建立差額的隨用隨付的 ECS 執行個體。例如：建立伸縮組時，指定 MinSize 為 5，在啟用伸縮組的 InstanceId.N 參數中指定 2 台已有 ECS 執行個體，則Auto Scaling在加入 2 台已有 ECS 執行個體之後，再自動建立 3 台 ECS 執行個體。
- 如果伸縮組的 Total Capacity 大於 MaxSize，則調用失敗。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ess:EnableScalingGroup

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

無

請求參數

名稱	類型	必填	描述	樣本值
ScalingGroupId	string	是	伸縮組的 ID。	asg-bp14wlu85wrpchm0****
ActiveScalingConfigurationId	string	否	需要在伸縮組內啟用的伸縮配置的 ID。	asc-bp1ffogfdauy0nu5****
LaunchTemplateId	string	否	執行個體啟動模板的 ID，用於指定伸縮組從執行個體啟動模板擷取啟動配置資訊。	lt-m5e3ofjr1zn1aw7****
LaunchTemplateVersion	string	否	執行個體啟動模板的版本。取值範圍：固定的模板版本號碼。 Default：始終使用模板預設版本。 Latest：始終使用模板最新版本。	Default
InstanceIds	array	否	啟用伸縮組後需要加入伸縮組的 ECS 執行個體的 ID。指定加入伸縮組的 ECS 執行個體需要滿足以下條件：必須與伸縮組在同一個地區。必須處於 Running 狀態。不能已加入到其他伸縮組中。付費方式為訂用帳戶、隨用隨付或搶佔式執行個體。如果伸縮組指定 VswitchID，則不支援 Classic 類型的 ECS 執行個體加入伸縮組，也不支援其他 VPC 的 ECS 執行個體加入伸縮組。如果伸縮組沒有指定 VswitchID，則不支援 VPC 類型的 ECS 執行個體加入伸縮組。
	string	否	啟用伸縮組後需要加入伸縮組的 ECS 執行個體的 ID。指定加入伸縮組的 ECS 執行個體需要滿足以下條件：必須與伸縮組在同一個地區。必須處於 Running 狀態。不能已加入到其他伸縮組中。付費方式為訂用帳戶、隨用隨付或搶佔式執行個體。如果伸縮組指定 VswitchID，則不支援 Classic 類型的 ECS 執行個體加入伸縮組，也不支援其他 VPC 的 ECS 執行個體加入伸縮組。如果伸縮組沒有指定 VswitchID，則不支援 VPC 類型的 ECS 執行個體加入伸縮組。	i-283vv****
LoadBalancerWeights	array	否	加入伸縮組中 ECS 執行個體或 ECI 執行個體作為後端伺服器的權重。預設值：50。
	integer	否	加入伸縮組中 ECS 執行個體或 ECI 執行個體作為後端伺服器的權重。預設值：50。	50
LaunchTemplateOverrides	array<object>	否	擴充啟動模板的執行個體規格資訊。
	object	否	擴充啟動模板的執行個體規格資訊。
InstanceType	string	否	當您需要伸縮組按照執行個體規格容量進行伸縮時，請同時指定本參數和`LaunchTemplateOverrides.WeightedCapacity`。本參數用於指定執行個體規格，會覆蓋啟動模板中的執行個體規格。說明僅當 LaunchTemplateId 參數指定了啟動模板時，本參數生效。 InstanceType 的取值範圍：在售的 ECS 執行個體規格。	ecs.c5.xlarge
WeightedCapacity	integer	否	當您需要伸縮組按照執行個體規格容量進行伸縮時，指定`LaunchTemplateOverrides.InstanceType`後，再指定本參數。本參數用於指定執行個體規格的權重，即執行個體規格的單台執行個體在伸縮組中表示的容量大小。權重越大，滿足期望容量所需的本執行個體規格的執行個體數量越少。由於每個執行個體規格的 vCPU 個數、記憶體大小等效能指標會有差異，您可以根據自身需求，給不同的執行個體規格配置不同的權重。例如：當前容量：0。期望容量：6。 ecs.c5.xlarge 規格容量：4。為滿足期望容量，伸縮組將為使用者擴容 2 台 ecs.c5.xlarge 執行個體。說明擴容時伸縮組的容量不得超過最大容量（MaxSize）與執行個體規格的最大權重之和。 WeightedCapacity 的取值範圍：1~500。	4
RegionId	string	否	伸縮組所屬的地區 ID。	cn-qingdao

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。