Auto Scaling：ModifyScalingGroup

待修改伸縮群組的 ID。

伸縮群組的名稱，同一地域下伸縮群組名稱唯一。長度為 2~64 個字元，以數字、大小英文字母或中文開頭，可以包含數字、底線（_）、短橫線（-）和半形句號（.）。

伸縮群組內 ECS 執行個體或 ECI 執行個體台數的最小值，當伸縮群組內 ECS 或 ECI 執行個體數小於 MinSize 時，彈性伸縮會自動建立 ECS 執行個體或 ECI 執行個體。

伸縮群組內 ECS 執行個體或 ECI 執行個體台數的最大值，當伸縮群組內 ECS 或 ECI 執行個體數大於 MaxSize 時，彈性伸縮會自動移出 ECS 執行個體或 ECI 執行個體。

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

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

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

冷卻時間內，該伸縮群組不執行其他的伸縮活動，僅針對雲端監控警示任務觸發的伸縮活動有效。

指定移出 ECS 執行個體的第一段伸縮群組策略。取值範圍：

• OldestInstance：移出最早加入伸縮群組的 ECS 執行個體。

• NewestInstance：移出最新加入伸縮群組的 ECS 執行個體。

• OldestScalingConfiguration：移出最早伸縮設定建立的 ECS 執行個體。

• CustomPolicy：基於自訂縮容策略 Function 函式移除 ECS 執行個體。

指定移出 ECS 執行個體的第二段伸縮群組策略。取值範圍：

• OldestInstance：移出最早加入伸縮群組的 ECS 執行個體。

• NewestInstance：移出最新加入伸縮群組的 ECS 執行個體。

• OldestScalingConfiguration：移出最早伸縮設定建立的 ECS 執行個體。

指定移出 ECS 執行個體的第三段伸縮群組策略。取值範圍：

• OldestInstance：移出最早加入伸縮群組的 ECS 執行個體。

• NewestInstance：移出最新加入伸縮群組的 ECS 執行個體。

• OldestScalingConfiguration：移出最早伸縮設定建立的 ECS 執行個體。

伸縮群組內生效的伸縮設定的 ID。

伸縮群組的健康檢查方式。取值範圍：

• NONE：不做健康檢查。

• ECS：對伸縮群組內的執行個體做健康檢查（ECS 類型和 ECI 類型的伸縮群組均使用本取值開啟執行個體健康檢查）。

• LOAD_BALANCER: 根據負載平衡（暫不支援 CLB 負載平衡類型）健康檢查結果判斷執行個體健康狀態。

預設值：ECS。

執行個體啟動範本 ID，用於指定伸縮群組從執行個體啟動範本取得啟動設定資訊。

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

• 固定的範本版本號。

• Default：始終使用範本預設版本。

• Latest：始終使用範本最新版本。

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

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

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

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

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

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

• true：允許。

• false：不允許。

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

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

伸縮群組內 ECS 執行個體或 ECI 執行個體的期望數量。設定該參數意味著開啟了期望執行個體數功能，伸縮群組會自動將 ECS 執行個體或 ECI 執行個體數量維持在期望執行個體數。取值範圍：MaxSize≥期望執行個體數量≥MinSize。

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

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

• false：關閉伸縮群組刪除保護。

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

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

• COST_OPTIMIZED：擴容時彈性伸縮按 vCPU 單價從低到高嘗試建立 ECS 執行個體，縮容時按 vCPU 單價從高到低嘗試移出 ECS 執行個體。當伸縮設定設定了搶佔式計費方式的多執行個體規格時，優先建立對應搶佔式執行個體。您可以繼續透過 CompensateWithOnDemand 參數，指定彈性伸縮在無法建立搶佔式執行個體時，是否自動嘗試建立隨選付費執行個體。

  說明

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

• BALANCE：在伸縮群組指定的多可用區之間均勻分配 ECS 執行個體。如果由於庫存不足等原因可用區之間變得不平衡，您可以透過 API RebalanceInstance 平衡資源。

• COMPOSABLE：是一種組合策略，您可以根據需要自主組合上述多可用區伸縮群組 ECS 執行個體的擴縮容策略。

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

• true：伸縮群組的容量在多個可用區間均衡分佈。

• false：伸縮群組的容量不在多個可用區間均衡分佈。

預設值：false。

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

• priority：按照設定的執行個體規格的順序建立執行個體。

• lowestPrice：按照執行個體規格單位 vCpu 價格從低到高建立執行個體。

預設值：priority。

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

• priority：按照設定的執行個體規格的順序建立執行個體。

• lowestPrice：按照執行個體規格單位 vCpu 價格從低到高建立執行個體。

預設值：priority。

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

取值範圍：0 或 [86400, Integer.maxValue]。其中，0 表示清空 MaxInstanceLifetime 設定過的值（即未設定 MaxInstanceLifetime 值）。

預設值：null。

自訂縮容策略 Function 函式 ARN。僅當 RemovalPolicies 設定第一個移除策略為 CustomPolicy 時生效。

伸縮群組是否關閉期望執行個體數功能。取值範圍：

• false：啟用期望執行個體數功能。

• true：關閉期望執行個體數功能。

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

• recycle：伸縮群組的回收模式為停機回收模式。

• release：伸縮群組的回收模式為釋放模式。

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

  說明

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

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

  說明

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

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

縮容流程中等待 ECS 執行個體停機成功的逾時時間，單位為秒。 取值範圍：30~240。

• 如果設定了該參數，系統會最長等待 StopInstanceTimeout 時間將執行個體停機成功，逾時後無論執行個體是否成功停機都會繼續縮容。

• 如果沒有設定該參數，系統會長時間等待執行個體停機成功，只有執行個體停機成功後才繼續縮容，停機失敗時，縮容流程會回滾，縮容失敗。

• 該參數設定為 0 時，表示取消該參數設定。

可用區均衡模式，僅當開啟可用區均衡模式時生效。取值範圍：

• BalancedBestEffort： 當某可用區資源建立失敗時，會降級至其他可用區，保障資源的盡力交付。

• BalancedOnly： 當某可用區資源建立失敗時，不會降級至其他可用區，擴容活動部分成功，避免資源在不同可用區過度不均衡。

預設值：BalancedBestEffort。

是否開啟伸縮群組自動均衡，僅當可用區均衡伸縮群組開啟了 BalancedOnly 才生效。取值範圍：

• false：不開啟伸縮群組自動均衡。

• true：開啟伸縮群組自動均衡時，伸縮群組會自動偵測可用區間容量，當可用區容量不均衡時，會主動進行可用區擴縮，進行可用區容量再均衡。

預設值: false。