全部產品
Search
文件中心

Auto Scaling:CreateScalingGroup

更新時間:Oct 23, 2026

如果您需要根據業務變動需求與策略自動增加或減少指定類型的執行個體數量,則可以透過呼叫 API CreateScalingGroup 建立伸縮群組來自動調整您的業務運算能力(即執行個體數量)。

介面說明

伸縮群組是具有相同應用場景的 ECS 執行個體的集合。

一個地域下支援建立的伸縮群組數量和彈性伸縮使用情況有關,請前往配額中心檢視伸縮群組總數對應的配額值。

伸縮群組建立成功後不會立即生效。您需要先呼叫 EnableScalingGroup 介面啟用伸縮群組,伸縮群組才能觸發伸縮活動和執行伸縮規則。

伸縮群組、關聯的傳統型負載平衡 CLB(原 SLB)執行個體和關聯的 RDS 執行個體必須在同一個地域。更多資訊,請參閱地域與可用區。

如果您為伸縮群組關聯了 CLB 執行個體,伸縮群組會自動將加入伸縮群組的 ECS 執行個體新增至 CLB 執行個體的後端伺服器群組。您可以指定 ECS 執行個體需要加入的伺服器群組,支援以下兩種伺服器群組:

  • 預設伺服器群組:用來接收前端請求的 ECS 執行個體,如果監聽沒有設定虛擬伺服器群組或主備伺服器群組,預設將請求轉送至預設伺服器群組中的 ECS 執行個體。

  • 虛擬伺服器群組:當您需要將不同的請求轉送到不同的後端伺服器上,或者需要透過網域名稱和 URL 進行請求轉送時,可以選擇使用虛擬伺服器群組。

說明

如果您同時指定了預設伺服器群組和多個虛擬伺服器群組,ECS 執行個體會同時新增至這些伺服器群組中。

執行個體在加入 CLB 執行個體的後端伺服器群組後,權重預設為 50。CLB 執行個體需要滿足以下條件:

  • 該 CLB 執行個體的狀態必須是 active,您可以呼叫 DescribeLoadBalancers 介面檢視指定 CLB 執行個體的狀態。

  • 該 CLB 執行個體設定的所有監聽連接埠必須開啟健康檢查,否則伸縮群組建立失敗。

如果您為伸縮群組關聯了應用型負載平衡 ALB 伺服器群組、網路型負載平衡 NLB 伺服器群組或閘道型負載平衡 GWLB 伺服器群組,伸縮群組會自動將加入伸縮群組的 ECS 執行個體新增為 ALB 伺服器群組、NLB 伺服器群組或 GWLB 伺服器群組的後端伺服器,處理 ALB 執行個體、NLB 執行個體或 GWLB 執行個體分發的存取請求。您可以指定多個 ALB 伺服器群組、NLB 伺服器群組或 GWLB 伺服器群組,但伺服器群組必須與伸縮群組屬於同一個 VPC。更多資訊,請參閱 AttachAlbServerGroups 或 AttachServerGroups 。

如果您為伸縮群組關聯了 RDS 執行個體,伸縮群組會自動將加入伸縮群組的 ECS 執行個體的內網 IP 新增至 RDS 執行個體的存取白名單。RDS 執行個體需要滿足以下條件:

  • 該 RDS 執行個體的狀態必須是 Running,您可以呼叫 DescribeDBInstances 介面檢視指定 RDS 執行個體的狀態。

  • 該 RDS 執行個體存取白名單的 IP 數不能超過上限值。更多資訊,請參閱 RDS 文件設定白名單。

如果伸縮群組的 MultiAZPolicy 設定為 COST_OPTIMIZED:

  • 當指定 OnDemandBaseCapacity、OnDemandPercentageAboveBaseCapacity 和 SpotInstancePools 參數時,即指定成本最佳化策略下的執行個體分配方式,在擴縮容時將優先滿足該執行個體分配方式。

  • 當不指定 OnDemandBaseCapacity、OnDemandPercentageAboveBaseCapacity 或 SpotInstancePools 參數時,成本最佳化策略下將僅按照成本最低的方式進行執行個體建立。(在此模式下,不支援透過彈性保障服務或容量預定服務建立執行個體;不支援設定輔助彈性網卡所屬的虛擬交換器參數)。

如果您為伸縮群組設定了可傳播標籤,即 Tags.Propagate 為 true 時:

  • 伸縮群組上的標籤只會傳播到新建立的執行個體上,而不會傳播到已經在伸縮群組中執行的執行個體上。

  • 如果您在伸縮組態中指定了執行個體標籤,並且選擇將伸縮群組的標籤傳播到該執行個體,則所有標籤都會同時存在。

  • 如果伸縮組態中的標籤和伸縮群組中的可傳播標籤指定了相同的標籤鍵,則優先使用伸縮組態中的標籤值。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ess:CreateScalingGroup

create

*ScalingGroup

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

無 無

請求參數

名稱

類型

必填

描述

樣本值

ScalingGroupName

string

否

伸縮群組的名稱,同一地域下伸縮群組名稱唯一。

長度為 2~64 個英文或中文字元,以數字、大小寫英文字母或中文開頭,可以包含數字、底線(_)、短橫線(-)和半形句點(.)。

預設值為 ScalingGroupId 的值。

scalinggroup****

LaunchTemplateId

string

否

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

lt-m5e3ofjr1zn1aw7****

LaunchTemplateVersion

string

否

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

  • 固定的範本版本號。

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

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

Default

InstanceId

string

否

執行個體的 ID。建立伸縮群組時,將從指定的執行個體取得所需的設定資訊,並自動建立伸縮組態。

i-28wt4****

RegionId

string

是

伸縮群組所屬的地域 ID。

cn-qingdao

MinSize

integer

是

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

說明

MinSize 的值必須小於或等於 MaxSize 的值。

2

MaxSize

integer

是

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

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

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

20

DefaultCooldown

integer

否

一次伸縮活動(新增或移出執行個體)結束後的一段冷卻時間。取值範圍:0~86400,單位:秒。

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

預設值:300。

300

LoadBalancerIds

string

否

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

單個伸縮群組可以關聯的 CLB 總數和彈性伸縮使用情況有關,請前往配額中心檢視單個伸縮群組可以關聯的負載平衡執行個體總數對應的配額值。

["lb-bp1u7etiogg38yvwz****", "lb-bp168cqrux9ai9l7f****", "lb-bp1jv3m9zvj22ufxp****"]

DBInstanceIds

string

否

RDS 執行個體 ID。取值可以是由多台 RDS 執行個體 ID 組成一個 JSON 陣列,ID 之間用半形逗號(,)隔開。

單個伸縮群組可以關聯的 RDS 執行個體總數和彈性伸縮使用情況有關,請前往配額中心檢視單個伸縮群組可以關聯的 RDS 執行個體總數對應的配額值。

["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]

RemovalPolicies

array

否

指定執行個體移出策略的篩選策略。取值範圍:

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

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

  • OldestScalingConfiguration:移出最早伸縮組態建立的 ECS 執行個體。

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

OldestScalingConfiguration 中提到的伸縮組態泛指群組內執行個體設定資訊來源,包括伸縮組態和啟動範本。CustomPolicy 僅支援設定為首位移除策略,當指定 CustomPolicy 需同時指定 CustomPolicyARN 參數。

說明

伸縮群組移出 ECS 執行個體還受伸縮群組的擴縮容策略(MultiAZPolicy)影響。更多資訊,請參閱設定移出執行個體的組合策略。

string

否

指定執行個體移出策略的篩選策略。取值範圍:

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

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

  • OldestScalingConfiguration:移出最早伸縮組態建立的 ECS 執行個體。

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

OldestScalingConfiguration 中提到的伸縮組態泛指群組內執行個體設定資訊來源,包括伸縮組態和啟動範本。CustomPolicy 僅支援設定為首位移除策略,當指定 CustomPolicy 需同時指定 CustomPolicyARN 參數。

說明

伸縮群組移出 ECS 執行個體還受伸縮群組的擴縮容策略(MultiAZPolicy)影響。更多資訊,請參閱設定移出執行個體的組合策略。

OldestScalingConfiguration

VSwitchId

string

否

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

說明

當伸縮群組未指定 VSwitchId 或 VSwitchIds 參數時,伸縮群組的網路類型預設為傳統網路。

vsw-bp14zolna43z266bq****

MultiAZPolicy

string

否

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

  • PRIORITY:先指定的虛擬交換器(VSwitchIds)優先順序最高。彈性伸縮優先在優先順序最高的交換器所在可用區嘗試擴縮容,如果無法擴縮容,則自動在下一優先順序的交換器所在可用區進行擴縮容。

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

    說明

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

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

    說明

    如果 MultiAZPolicy 參數取值為 BALANCE 時,其和 MultiAZPolicy 參數取值為 COMPOSABLE 策略且 AzBalance 參數取值為 true 時的效果相同。

  • COMPOSABLE:是一種組合策略,您可以根據需要自主組合上述多可用區伸縮群組 ECS 執行個體的擴縮容策略。或者進一步指定參數,對伸縮群組的容量進行更精細地控制。

預設值:PRIORITY。

PRIORITY

HealthCheckType

string

否

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

  • NONE:不做健康檢查。

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

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

預設值:ECS。

說明

如果需要同時開啟執行個體健康檢查和負載平衡健康檢查,請使用 HealthCheckTypes 參數。

ECS

ScalingPolicy

string

否

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

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

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

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

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

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

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

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

recycle

ClientToken

string

否

保證請求冪等性。

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

123e4567-e89b-12d3-a456-42665544****

OnDemandBaseCapacity

integer

否

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

30

OnDemandPercentageAboveBaseCapacity

integer

否

伸縮群組滿足最小隨用隨付執行個體數(OnDemandBaseCapacity)要求後,超出的執行個體中隨用隨付執行個體應佔的比例,取值範圍:0~100。

20

SpotInstanceRemedy

boolean

否

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

true

CompensateWithOnDemand

boolean

否

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

  • true:允許。

  • false:不允許。

預設值:true。

true

SpotInstancePools

integer

否

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

5

DesiredCapacity

integer

否

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

5

GroupDeletionProtection

boolean

否

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

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

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

預設值:false。

true

GroupType

string

否

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

  • ECS:伸縮群組內管理的伸縮為 ECS 執行個體。

  • ECI:伸縮群組內管理的伸縮為 ECI 執行個體。

預設值:ECS。

ECS

ContainerGroupId

string

否

ECI 執行個體 ID,即容器群組 ID。

eci-uf6fonnghi50u374****

VSwitchIds

array

否

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

指定多台虛擬交換器時:

  • 所屬的 VPC 必須相同。

  • 所屬的可用區可以不同。

  • 虛擬交換器的優先順序按照數字升序排序,1 表示最高優先順序。當優先順序較高的虛擬交換器所在可用區無法建立執行個體時,自動選擇下一優先順序的虛擬交換器建立執行個體。

說明

當伸縮群組未指定 VSwitchId 或 VSwitchIds 參數時,伸縮群組的網路類型預設為傳統網路。

string

否

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

指定多台虛擬交換器時:

  • 所屬的 VPC 必須相同。

  • 所屬的可用區可以不同。

  • 虛擬交換器的優先順序按照數字升序排序,1 表示最高優先順序。當優先順序較高的虛擬交換器所在可用區無法建立執行個體時,自動選擇下一優先順序的虛擬交換器建立執行個體。

說明

當伸縮群組未指定 VSwitchId 或 VSwitchIds 參數時,伸縮群組的網路類型預設為傳統網路。

vsw-bp14zolna43z266bq****

LifecycleHooks

array<object>

否

生命週期掛鉤資訊清單。

object

否

生命週期掛鉤資訊清單。

DefaultResult

string

否

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

  • CONTINUE:繼續回應彈性擴張活動或者繼續回應彈性收縮活動。

  • ABANDON:直接釋放彈性擴張活動建立出來的執行個體或者直接將彈性收縮活動中的執行個體從伸縮群組移除。

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

預設值:CONTINUE。

CONTINUE

LifecycleHookName

string

否

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

lifecyclehook****

LifecycleTransition

string

否

生命週期掛鉤適用的伸縮活動類型,取值範圍:

  • SCALE_OUT:伸縮群組彈性擴張活動。

  • SCALE_IN:伸縮群組彈性收縮活動。

說明

若伸縮群組指定生命週期掛鉤,此參數必選,其他相關參數可選。

SCALE_OUT

NotificationMetadata

string

否

伸縮活動的等待狀態的固定字串資訊。參數長度不超過 4096 個字元。彈性伸縮每次推送訊息到通知對象時,會同時傳送您預先指定的 notificationmetadata 參數值,便於管理和標記不同類別的通知資訊。當您同時指定了 notificationarn 參數時,notificationmetadata 才有效。

Test

NotificationArn

string

否

生命週期掛鉤通知對象識別碼,支援輕量訊息佇列(原 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}。

acs:ess:cn-hangzhou:1111111111:queue/queue2

HeartbeatTimeout

integer

否

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

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

預設值:600。

600

VServerGroups

array<object>

否

伸縮群組關聯虛擬伺服器群組的資訊集合。

array<object>

否

伸縮群組關聯虛擬伺服器群組的資訊集合。

VServerGroupAttributes

array<object>

否

後端伺服器群組屬性。

object

否

後端伺服器群組屬性。

VServerGroupId

string

否

虛擬伺服器群組 ID。

rsp-bp1443g77****

Weight

integer

否

彈性伸縮將執行個體新增至虛擬伺服器群組後,執行個體作為後端伺服器的權重。權重越高,執行個體將被分配到越多的存取請求。如果權重為 0,則執行個體不會收到存取請求。取值範圍:0~100。

預設值:50。

100

Port

integer

否

彈性伸縮將執行個體新增至虛擬伺服器群組後,執行個體使用的連接埠號,取值範圍:1~65535。

22

LoadBalancerId

string

否

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

lb-bp1u7etiogg38yvwz****

Tags

array<object>

否

伸縮群組的標籤資訊集合。

object

否

伸縮群組的標籤資訊集合。

Key

string

否

伸縮群組的標籤鍵。

Department

Value

string

否

伸縮群組的標籤值。

Finance

Propagate

boolean

否

識別該標籤是否為可傳播標籤,取值範圍:

  • true:伸縮群組上的標籤只會傳播到新建立的執行個體上,而不會傳播到已經在伸縮群組中執行的執行個體上。

  • false:伸縮群組上的標籤不會傳播到執行個體上。

預設值:false。

false

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

SpotPriceLimit

number

否

本參數用於指定執行個體啟動範本覆蓋規格(即 LaunchTemplateOverride.InstanceType)的競價價格上限。

說明

僅當 LaunchTemplateId 參數指定了啟動範本時,該參數才生效。

0.025

AlbServerGroups

array<object>

否

ALB 伺服器群組的相關資訊集合。

object

否

ALB 伺服器群組的相關資訊集合。

AlbServerGroupId

string

否

ALB 伺服器群組的 ID。

一個伸縮群組支援關聯的 ALB 伺服器群組數量有限,如需檢視或手動申請提升配額值,請前往配額中心。

sgp-ddwb0y0g6y9bjm****

Weight

integer

否

彈性伸縮將執行個體新增至 ALB 伺服器群組後,執行個體作為後端伺服器的權重。權重越高,執行個體將被分配到越多的存取請求。如果權重為 0,則執行個體不會收到存取請求。取值範圍:0~100。

100

Port

integer

否

彈性伸縮將執行個體新增至 ALB 伺服器群組後,執行個體使用的連接埠號,取值範圍:1~65535。

22

ServerGroups

array<object>

否

負載平衡伺服器群組的相關資訊集合。

說明

不支援同時在 AlbServerGroups 和 ServerGroups 中設定相同的伺服器群組資訊。

object

否

負載平衡伺服器群組的相關資訊集合。

ServerGroupId

string

否

伺服器群組 ID。

sgp-5yc3bd9lfyh*****

Type

string

否

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

  • ALB:表示應用型負載平衡(Application Load Balancer)。

  • NLB:表示網路型負載平衡(Network Load Balancer)。

  • GWLB:閘道型負載平衡 GWLB(Gateway Load Balancer)。

ALB

Weight

integer

否

彈性伸縮將執行個體新增至伺服器群組後,執行個體作為後端伺服器的權重。取值範圍:0~100。

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

說明

ALB 和 NLB 類型負載平衡該參數為必填參數,GWLB 類型負載平衡不能設定該參數。

100

Port

integer

否

彈性伸縮將執行個體新增至伺服器群組後,執行個體使用的連接埠號,取值範圍:1~65535。

22

AzBalance

boolean

否

伸縮群組的容量是否在其中多個可用區間均衡分佈(僅當MultiAZPolicy參數取值為COMPOSABLE策略時生效),取值範圍:

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

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

說明

如果MultiAZPolicy參數取值為COMPOSABLE策略,並且AzBalance參數取值為true時,其效果和MultiAZPolicy參數取值為BALANCE相同。

預設值:false。

false

AllocationStrategy

string

否

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

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

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

預設值:priority。

priority

SpotAllocationStrategy

string

否

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

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

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

預設值:priority。

lowestPrice

SyncAlarmRuleToCms

boolean

否

說明

該參數暫未開放使用。

false

MaxInstanceLifetime

integer

否

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

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

預設值:null。

86400

CustomPolicyARN

string

否

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

acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name

ResourceGroupId

string

否

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

說明

將新建立的伸縮群組歸屬到指定的資源群組中。如果不指定該參數,則歸屬為預設資源群組。

rg-123******

LoadBalancerConfigs

array<object>

否

負載平衡設定列表。

object

否

負載平衡 CLB(原 SLB)設定列表。

LoadBalancerId

string

否

負載平衡 CLB(原 SLB)執行個體的 ID。

lb-2zen1olhfg9yw3f4q****

Weight

integer

否

彈性伸縮將執行個體新增至 SLB 伺服器群組後,執行個體作為後端伺服器的權重。權重越高,執行個體將被分配到越多的存取請求。如果權重為 0,則執行個體不會收到存取請求。取值範圍:0~100。

10

HealthCheckTypes

array

否

伸縮群組的健康檢查方式。

說明

使用此參數可以設定多個值,開啟多個健康檢查選項。如果設定了HealthCheckType參數,則本參數將被忽略。

string

否

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

  • NONE:不做健康檢查。

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

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

預設值:ECS。

ECS

DBInstances

array<object>

否

伸縮群組關聯的資料庫列表。

object

否

伸縮群組關聯的資料庫設定資訊。

DBInstanceId

string

否

資料庫執行個體 ID。

rm-m5eqju85s45mu0***

Type

string

否

資料庫類型。取值範圍:

  • RDS。

  • Redis。

  • MongoDB。

預設值:RDS。

RDS

AttachMode

string

否

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

  • SecurityIp :修改 IP 白名單模式,透過將擴容執行個體自動新增至資料庫 IP 白名單(目前僅 RDS 資料庫支援)。

  • SecurityGroup:安全性群組模式,透過將伸縮設定安全性群組新增至資料庫安全性群組白名單,實現安全性群組下執行個體資料庫存取。

SecurityIp

StopInstanceTimeout

integer

否

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

說明
  • 該參數僅在 ScalingPolicy = release 模式下的縮容流程裡生效。

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

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

60

CapacityOptions

object

否

容量選項。

OnDemandBaseCapacity

integer

否

已有伸縮群組內所需要的隨用隨付執行個體數的最小值,當伸縮群組內隨用隨付執行個體個數少於該值時,系統將優先建立隨用隨付執行個體。取值範圍:0~1000。

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

30

OnDemandPercentageAboveBaseCapacity

integer

否

伸縮群組滿足最小隨用隨付執行個體數OnDemandBaseCapacity要求後,超出的執行個體中隨用隨付執行個體應佔的比例。取值範圍:0~100。

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

20

CompensateWithOnDemand

boolean

否

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

  • true:允許。

  • false:不允許。

預設值:true。

true

SpotAutoReplaceOnDemand

boolean

否

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

  • true:允許。

  • false:不允許。

預設值:false。

false

PriceComparisonMode

string

否

伸縮群組成本最佳化策略的比價模式。取值範圍:

  • PricePerUnit:使用每單位容量價格比價。

    執行個體在伸縮群組中容量大小等於為執行個體規格設定的權重,預設為 1,即一台 ECS 所佔容量為 1。

  • PricePerVCpu:使用每單位 vCpu 價格進行比價。

預設值:PricePerUnit。

PricePerUnit

BalanceMode

string

否

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

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

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

預設值:BalancedBestEffort。

BalancedBestEffort

AutoRebalance

boolean

否

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

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

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

預設值:false。

false

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ScalingGroupId

string

伸縮群組 ID。

asg-bp14wlu85wrpchm0****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

404 ResourceNotAvailable.VPCNetwork The specified zone does not support vpc network or sold out.

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

變更歷史

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