全部產品
Search
文件中心

Auto Scaling:AttachLoadBalancers

更新時間:Sep 10, 2026

新增一個或多個負載平衡執行個體。

介面說明

介面說明

向伸縮組新增負載平衡執行個體時需要滿足以下條件:

  • 負載平衡執行個體與伸縮組必須屬於同一帳號和同一個地域。

  • 負載平衡執行個體必須處於運行中狀態。

  • 負載平衡執行個體至少配置有一個監聽且必須開啟健康檢查。

  • 如果負載平衡執行個體與伸縮組的網路類型均為 VPC,必須處於同一 VPC。

  • 當伸縮組的網路類型為 VPC,負載平衡執行個體的網路類型為經典網路時,如果負載平衡執行個體後端伺服器中包含 VPC 執行個體,該執行個體必須與伸縮組處於同一 VPC。

  • 不超過伸縮組關聯負載平衡執行個體的限額,具體限額,請參見使用限制

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

ScalingGroupId

string

伸縮組的 ID。

asg-bp1avr6ensitts3w****

ForceAttach

boolean

是否把當前伸縮組內的執行個體全部新增為負載平衡 CLB(原 SLB)執行個體的後端伺服器。取值範圍:

  • true:新增。如果該參數值為true,則將負載平衡執行個體新增到伸縮組時,系統會將當前伸縮組中已有的執行個體全部新增為負載平衡執行個體的後端伺服器。

    說明

    如果負載平衡執行個體已新增至伸縮組,而您需要將伸縮組中全部執行個體新增為該負載平衡執行個體的後端伺服器,則您可以再次將該負載平衡執行個體新增到伸縮組,並選擇ForceAttachtrue狀態。

  • false:不新增。如果該參數值為false,則將負載平衡執行個體新增到伸縮組時,系統不會將當前伸縮組中已有的執行個體新增為負載平衡執行個體的後端伺服器。

預設值:false。

false

ClientToken

string

保證請求冪等性。

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

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

Async

boolean

新增負載平衡 CLB(原 SLB)執行個體時,是否採用非同步呼叫的方式。非同步呼叫能保證操作的事務性,即所有操作都執行成功或者某個操作失敗時所有操作的執行結果都不生效,建議您採用非同步呼叫。

取值範圍:

  • true:非同步呼叫。請求將返回伸縮活動的 ID。

  • false:同步呼叫。

預設值:false。

false

LoadBalancer

array

需要新增的負載平衡 CLB(原 SLB)執行個體的 ID 列表,N 的取值範圍:1~5。

lb-2zeur05gfs****

string

需要新增的負載平衡 CLB(原 SLB)執行個體的 ID 列表,N 的取值範圍:1~5。

說明

支援最多一次新增 5 個負載平衡執行個體到伸縮組。

lb-2zeur05gfs****

LoadBalancerConfig

array<object>

負載平衡 CLB(原 SLB)配置列表。

object

負載平衡 CLB(原 SLB)配置列表。

LoadBalancerId

string

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

147b46d767c-cn-qingdao-cm5****

Weight

integer

彈性伸縮將 ECS 執行個體或 ECI 執行個體新增到 CLB(原 SLB)伺服器組後,ECS 執行個體或 ECI 執行個體作為後端伺服器的權重。權重越高,ECS 執行個體或 ECI 執行個體將被分配到越多的存取請求。如果權重為 0,則 ECS 執行個體或 ECI 執行個體不會收到存取請求。

取值範圍:0~100。

10

返回參數

名稱

類型

描述

樣本值

object

ScalingActivityId

string

伸縮活動的 ID。

僅當Asynctrue時返回該值。您可使用 API DescribeScalingActivities 遍歷查詢返回的伸縮活動 ID,查看伸縮活動的執行狀態。

asa-bp140qd7mak8k63f****

RequestId

string

請求 ID。

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

樣本

正常返回樣本

JSON格式

{
  "ScalingActivityId": "asa-bp140qd7mak8k63f****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情