Auto Scaling：CreateScalingGroup

系統規定參數。取值：CreateScalingGroup。

伸縮組的名稱，同一地區下伸縮組名稱唯一。

長度為2~64個英文或中文字元，以數字、大小寫英文字母或中文開頭，可以包含數字、底線（_）、短劃線（-）和半形句號（.）。

預設值為ScalingGroupId的值。

執行個體啟動模板ID，用於指定伸縮組從執行個體啟動模板擷取啟動配置資訊。

執行個體啟動模板的版本。取值範圍：

• 固定的模板版本號碼。
• Default：始終使用模板預設版本。
• Latest：始終使用模板最新版本。

執行個體的ID。建立伸縮組時，將從指定的執行個體擷取所需的配置資訊，並自動建立伸縮配置。

伸縮組所屬的地區ID。更多資訊，請參見地區與可用性區域。

伸縮組內執行個體台數的最小值，當伸縮組內執行個體數小於MinSize的值時，Auto Scaling會自動建立執行個體。

伸縮組內執行個體台數的最大值，當伸縮組內實數大於MaxSize的值時，Auto Scaling會自動移出執行個體。

MaxSize的取值範圍和Auto Scaling使用方式有關，請前往配額中心查看單個伸縮組可以設定的組內最大執行個體數對應的配額值。

如果單個伸縮組可以設定的組內最大執行個體數對應的配額值為2000，則MaxSize的取值範圍為0~2000。

一次伸縮活動（添加或移出執行個體）結束後的一段冷卻時間。取值範圍：0~86400，單位：秒。

冷卻時間內，該伸縮組不執行其它的伸縮活動，僅針對CloudMonitor警示任務觸發的伸縮活動有效。

預設值：300。

傳統型負載平衡CLB（原SLB）執行個體ID。取值可以是由多台CLB執行個體ID組成一個JSON數組，ID之間用半形逗號（,）隔開。

單個伸縮組可以關聯的CLB總數和Auto Scaling使用方式有關，請前往配額中心查看單個伸縮組可以關聯的Server Load Balancer執行個體總數對應的配額值。

RDS執行個體ID。取值可以是由多台RDS執行個體ID組成一個JSON數組，ID之間用半形逗號（,）隔開。

單個伸縮組可以關聯的RDS執行個體總數和Auto Scaling使用方式有關，請前往配額中心查看單個伸縮組可以關聯的RDS執行個體總數對應的配額值。

指定執行個體移出策略的第一段篩選策略。不允許與RemovalPolicy.2和RemovalPolicy.3取值相同。取值範圍：

• OldestInstance：移出最早加入伸縮組的ECS執行個體。
• NewestInstance：移出最新加入伸縮組的ECS執行個體。
• OldestScalingConfiguration：移出最早伸縮配置建立的ECS執行個體。
• CustomPolicy：基於自訂縮容策略Function函數移除ECS執行個體。

OldestScalingConfiguration中提到的伸縮配置泛指組內執行個體配置資訊來源，包括伸縮配置和啟動模板。CustomPolicy僅支援設定為首位移出策略，當指定CustomPolicy需同時指定CustomPolicyARN參數。

指定執行個體移出策略的第二段篩選策略，不允許與RemovalPolicy.1和RemovalPolicy.3取值相同。取值範圍：

• OldestInstance：移出最早加入伸縮組的ECS執行個體。
• NewestInstance：移出最新加入伸縮組的ECS執行個體。
• OldestScalingConfiguration：移出最早伸縮配置建立的ECS執行個體。

指定執行個體移出策略的第三段篩選策略，不允許與RemovalPolicy.1和RemovalPolicy.2取值相同。取值範圍：

• OldestInstance：移出最早加入伸縮組的ECS執行個體。
• NewestInstance：移出最新加入伸縮組的ECS執行個體。
• OldestScalingConfiguration：移出最早伸縮配置建立的ECS執行個體。

虛擬交換器的ID。指定後，伸縮組的網路類型為專用網路。

多可用性區域伸縮組ECS執行個體擴縮容策略。取值範圍：

• PRIORITY：先指定的虛擬交換器（VSwitchIds.N）優先順序最高。Auto Scaling優先在優先順序最高的交換器所在可用性區域嘗試擴縮容，如果無法擴縮容，則自動在下一優先順序的交換器所在可用性區域進行擴縮容。

• COST_OPTIMIZED：擴容時Auto Scaling按vCPU單價從低到高嘗試建立ECS執行個體，縮容時按vCPU單價從高到低嘗試移出ECS執行個體。當伸縮配置設定了搶佔式計費方式的多執行個體規格時，優先建立對應搶佔式執行個體。您可以繼續通過CompensateWithOnDemand參數指定當搶佔式執行個體由於庫存等原因無法建立時，是否自動嘗試以隨用隨付的方式建立。

  說明 COST_OPTIMIZED僅在伸縮配置設定了多執行個體規格或者選用了搶佔式執行個體的情況下生效。

• BALANCE：在伸縮組指定的多可用性區域之間均勻分配ECS執行個體。如果由於庫存不足等原因可用性區域之間變得不平衡，您可以通過API RebalanceInstance平衡資源。
• COMPOSABLE：是一種組合策略，您可以根據需要自主組合上述多可用性區域伸縮組ECS執行個體的擴縮容策略。或者進一步指定參數，對伸縮組的容量進行更精細地控制。

預設值：PRIORITY。

伸縮組的健全狀態檢查方式。取值範圍：

• NONE：不做健全狀態檢查。
• ECS：對伸縮組內的執行個體做健全狀態檢查（ECS類型和ECI類型的伸縮組均使用本取值開啟執行個體健全狀態檢查）。
• LOAD_BALANCER: 根據負載平衡（暫不支援CLB負載平衡類型）健全狀態檢查結果判斷執行個體健康狀態。

預設值：ECS。

指定伸縮組的回收模式。取值範圍：

• recycle：伸縮組的回收模式為停機回收模式。
• release：伸縮組的回收模式為釋放模式。

• forcerelease：伸縮組的回收模式為強制釋放模式。

  說明 選擇forcerelease後，在彈性收縮活動中系統會強制釋放運行中（Running）的執行個體。強制釋放執行個體相當於斷電操作，會導致該執行個體記憶體以及儲存中的臨時資料被擦除，資料無法恢複，請您謹慎選擇。

• forcerecycle：伸縮組的回收模式為強制停機回收模式。

  說明 選擇forcerecycle後，在彈性收縮活動中系統會強制關機運行中（Running）的執行個體。強制關機相當於斷電操作，會導致該執行個體記憶體以及儲存中的臨時資料被擦除，資料無法恢複，請您謹慎選擇。

ScalingPolicy指定伸縮組的回收模式，但執行個體被移出伸縮組時的具體動作，由RemoveInstances的RemovePolicy參數決定，更多資訊，請參見RemoveInstances。

保證請求等冪性。

從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援ASCII字元，且不能超過64個字元。更多資訊，請參見如何保證等冪性。

伸縮組所需要按量執行個體個數的最小值，取值範圍：0~1000。當按量執行個體個數少於該值時，將優先建立按量執行個體。

當MultiAZPolicy參數取值為COMPOSABLE策略時，預設值為0。

伸縮組滿足最小按量執行個體數（OnDemandBaseCapacity）要求後，超出的執行個體中按量執行個體應占的比例，取值範圍：0～100。

當MultiAZPolicy參數取值為COMPOSABLE策略時，預設值為100。

是否開啟補齊搶佔式執行個體。開啟後，當收到搶佔式執行個體將被回收的系統訊息時，伸縮組將嘗試建立新的執行個體，替換掉將被回收的搶佔式執行個體。

當MultiAZPolicy取值為COST_OPTIMIZED時，如果因價格、庫存等原因無法建立足夠的搶佔式執行個體，是否允許自動嘗試建立按量執行個體滿足ECS執行個體數量要求。取值範圍：

• true：允許。
• false：不允許。

預設值：true。

指定可用執行個體規格的個數，伸縮組將按成本最低的多個規格均衡建立搶佔式執行個體。取值範圍：1~10。

當MultiAZPolicy參數取值為COMPOSABLE策略時，預設值為2。

伸縮組內ECS執行個體的期望數量，伸縮組會自動將ECS執行個體數量維持在期望執行個體數。取值不得大於MaxSize，且不得小於MinSize。

是否開啟伸縮組刪除保護。取值範圍：

• true：開啟伸縮組刪除保護，此時不能刪除該伸縮組。
• false：關閉伸縮組刪除保護。

預設值：false。

伸縮組管理的執行個體類型。取值範圍：

• ECS：伸縮組內管理的伸縮執行個體為ECS執行個體。
• ECI：伸縮組內管理的伸縮執行個體為ECI執行個體。

預設值：ECS。

ECI執行個體ID，即容器組ID。

一台或多台虛擬交換器的ID。如果您使用了VSwitchIds.N參數，VSwitchId參數將被忽略。指定後，伸縮組的網路類型為專用網路。

指定多台虛擬交換器時：

• 所屬的VPC必須相同。
• 所屬的可用性區域可以不同。
• 虛擬交換器的優先順序按照數字升序排序，1表示最高優先順序。當優先順序較高的虛擬交換器所在可用性區域無法建立ECS執行個體時，自動選擇下一優先順序的虛擬交換器建立ECS執行個體。

等待狀態結束後的下一步動作。取值範圍：

• CONTINUE：繼續響應彈性擴張活動或者繼續響應彈性收縮活動。
• ABANDON：直接釋放彈性擴張活動建立出來的ECS執行個體或者直接將彈性收縮活動中的ECS執行個體從伸縮組移除。

當伸縮組發生彈性收縮活動（SCALE_IN）並觸發多個生命週期掛鈎時，DefaultResult取值為ABANDON的生命週期掛鈎觸發的等待狀態結束時，會提前結束其它對應的等待狀態。其他情況下，下一步動作均以最後一個結束等待狀態的下一步動作為準。

預設值：CONTINUE。

生命週期掛鈎名稱，指定後不支援修改，未指定時預設與生命週期掛鈎ID相同。

生命週期掛鈎適用的伸縮活動類型，取值範圍：

• SCALE_OUT：伸縮組彈性擴張活動。
• SCALE_IN：伸縮組彈性收縮活動。

伸縮活動的等待狀態的固定字串資訊。參數長度不能超過128個字元。Auto Scaling每次推送訊息到通知對象時，會同時發送您預先指定的NotificationMetadata參數值，便於管理和標記不同類別的通知資訊。當您同時指定了NotificationArn參數時，NotificationMetadata參數方可生效。

生命週期掛鈎通知物件識別碼，支援輕量訊息佇列（原 MNS）的隊列或主題，參數取值格式：acs:ess:{region}:{account-id}:{resource-relative-id}。

• region：伸縮組所在的地區。
• account-id：阿里雲帳號ID。

例如：

• MNS隊列：acs:ess:{region}:{account-id}:queue/{queuename}。
• MNS主題：acs:ess:{region}:{account-id}:topic/{topicname}。

生命週期掛鈎為伸縮組活動設定的等待時間，等待狀態逾時後會執行下一步動作。取值範圍：30~21600，單位：秒。

建立了生命週期掛鈎後，您可以調用RecordLifecycleActionHeartbeat延長ECS執行個體的等待時間，也可以調用CompleteLifecycleAction提前結束伸縮活動的等待狀態。

預設值：600。

虛擬伺服器組ID。

更多資訊，請參見AttachVServerGroups。

Auto Scaling將執行個體添加到虛擬伺服器組後，執行個體作為後端伺服器的權重。權重越高，執行個體將被分配到越多的訪問請求。如果權重為0，則執行個體不會收到訪問請求。取值範圍：0~100。預設值：50。

更多資訊，請參見AttachVServerGroups。

Auto Scaling將執行個體添加到虛擬伺服器組後，執行個體使用的連接埠號碼，取值範圍：1~65535。

更多資訊，請參見AttachVServerGroups。

虛擬伺服器組所屬傳統型負載平衡CLB（原SLB）執行個體的ID。

更多資訊，請參見AttachVServerGroups。

伸縮組的標籤鍵。

伸縮組的標籤值。

標識該標籤是否為可傳播標籤，取值範圍：

• true：伸縮組上的標籤只會傳播到新建立的執行個體上，而不會傳播到已經在伸縮組中啟動並執行執行個體上。
• false：伸縮組上的標籤不會傳播到執行個體上。

預設值：false。

當您需要伸縮組按照執行個體規格容量進行伸縮時，請同時指定本參數和LaunchTemplateOverride.N.WeightedCapacity。

本參數用於指定執行個體規格，會覆蓋啟動模板中的執行個體規格。您可以指定N個本參數，擴充啟動模板支援N個執行個體規格。N的取值範圍：1~10。

InstanceType的取值範圍：在售的ECS執行個體規格，請參見執行個體規格類型系列。

當您需要伸縮組按照執行個體規格容量進行伸縮時，在指定LaunchTemplateOverride.N.InstanceType後，再指定本參數。兩個參數一一對應，N需要保持一致。

本參數用於指定執行個體規格的權重，即執行個體規格的單台執行個體在伸縮組中表示的容量大小。權重越大，滿足期望容量所需的本執行個體規格的執行個體數量越少。

由於每個執行個體規格的vCPU個數、記憶體大小等效能指標會有差異，您可以根據自身需求，給不同的執行個體規格配置不同的權重。

例如：

• 當前容量：0。
• 期望容量：6。
• ecs.c5.xlarge規格容量：4。

為滿足期望容量，伸縮組將為使用者擴容2台ecs.c5.xlarge執行個體。

WeightedCapacity的取值範圍：1~500。

本參數用於指定執行個體啟動模板覆蓋規格（即LaunchTemplateOverride.N.InstanceType）的競價價格上限。您可以指定N個該參數，擴充啟動模板支援N個執行個體規格。N的取值範圍：1~10。

ALB伺服器組ID。

N為ALB伺服器組的編號。一個伸縮組支援關聯的ALB伺服器組數量有限，如需查看或手動申請提升配額值，請前往配額中心。

Auto Scaling將執行個體添加到ALB伺服器組後，執行個體作為後端伺服器的權重。權重越高，執行個體將被分配到越多的訪問請求。如果權重為0，則執行個體不會收到訪問請求。取值範圍：0~100。

N為ALB伺服器組的編號。

Auto Scaling將執行個體添加到ALB伺服器組後，執行個體使用的連接埠號碼，取值範圍：1~65535。

N為ALB伺服器組的編號。

伺服器組的ID。

伺服器群組類型。取值範圍：

• ALB：表示應用型負載平衡（Application Load Balancer）。
• NLB：表示網路型負載平衡（Network Load Balancer）。

Auto Scaling將執行個體添加到伺服器組後，執行個體作為後端伺服器的權重。取值範圍：0~100。

權重越高，執行個體將被分配到越多的訪問請求。如果權重為0，則執行個體不會收到訪問請求。

Auto Scaling將執行個體添加到伺服器組後，執行個體使用的連接埠號碼。取值範圍：1~65535。

伸縮組的容量是否在多個可用性區域間均衡分布（僅當MultiAZPolicy參數取值為COMPOSABLE策略時生效），取值範圍：

• true：伸縮組的容量在多個可用性區域間均衡分布。
• false：伸縮組的容量不在多個可用性區域間均衡分布。

預設值：false。

容量分配策略，決定了伸縮組如何選擇可用的執行個體規格類型滿足容量。容量分布策略同時對按量和搶佔式容量生效（僅當MultiAZPolicy參數取值為COMPOSABLE策略時生效）。取值範圍：

• priority：按照配置的執行個體規格的順序建立執行個體。
• lowestPrice：按照執行個體規格單位vCpu價格從低到高建立執行個體。

預設值：priority。

搶佔式容量分布策略。您可以通過該參數單獨指定搶佔式容量的分布策略（僅當MultiAZPolicy參數取值為COMPOSABLE策略時生效）。取值範圍：

• priority：按照配置的執行個體規格的順序建立執行個體。
• lowestPrice：按照執行個體規格單位vCpu價格從低到高建立執行個體。

預設值：priority。

執行個體在伸縮組中存活的最大時間。單位為秒。

取值範圍：[86400, Integer.maxValue]。

預設值：null。

自訂縮容策略Function函數ARN。僅當RemovalPolicies配置第一個移除策略為CustomPolicy時生效。

新建立的伸縮組所屬的資源群組ID。

負載平衡CLB（原SLB）執行個體的ID。

Auto Scaling將執行個體添加到負載平衡CLB（原SLB）伺服器組後，執行個體作為後端伺服器的權重。權重越高，執行個體將被分配到越多的訪問請求。如果權重為0，則執行個體不會收到訪問請求。

取值範圍：0~100。

伸縮組的健全狀態檢查方式列表。取值範圍：

• NONE：不做健全狀態檢查。
• ECS：對伸縮組內的執行個體做健全狀態檢查（ECS類型和ECI類型的伸縮組均使用本取值開啟執行個體健全狀態檢查）。
• LOAD_BALANCER: 根據負載平衡（暫不支援負載平衡CLB類型）健全狀態檢查結果判斷執行個體健康狀態。

預設值：ECS。

資料庫執行個體ID。

資料庫類型。取值範圍：

• RDS。
• Redis。
• MongoDB。

預設值：RDS。

伸縮組與資料庫關聯方式。取值範圍：

• SecurityIp ：修改IP白名單模式，通過將擴容執行個體自動添加到資料庫IP白名單（目前僅RDS資料庫支援）。
• SecurityGroup：安全性群組模式，通過將伸縮配置安全性群組添加至資料庫安全性群組白名單，實現安全性群組下執行個體資料庫訪問。

縮容流程中等待ECS執行個體停機成功的逾時時間，單位為秒。

取值範圍：30~240。

已有伸縮組內所需要的按量執行個體數的最小值，當伸縮組內按量執行個體個數少於該值時，系統將優先建立按量執行個體。取值範圍：0~1000。

當MultiAZPolicy參數取值為COMPOSABLE策略時，預設值為0。

伸縮組滿足最小按量執行個體數OnDemandBaseCapacity要求後，超出的執行個體中按量執行個體應占的比例。取值範圍：0～100。

當MultiAZPolicy參數取值為COMPOSABLE策略時，預設值為100。

當MultiAZPolicy取值為COST_OPTIMIZED時，如果因價格、庫存等原因無法建立足夠的搶佔式執行個體，是否允許自動嘗試建立按量執行個體滿足ECS執行個體數量要求。取值範圍：

• true：允許。
• false：不允許。

預設值：true。

當開啟CompensateWithOnDemand後，如果按量比例超過OnDemandPercentageAboveBaseCapacity比例時，會嘗試使用spot替換按量容量。常見情境CompensateWithOnDemand因Spot庫存或價格原因導致Spot降級按量執行個體，為避免按量執行個體長時間存在，嘗試使用Spot替換多餘的按量容量。取值範圍：

• true：允許。
• false：不允許。

預設值：false。

請求ID。

伸縮組ID。