全部產品
Search

搜尋本產品

    Auto Scaling：AttachServerGroups

    文件中心

    Auto Scaling：AttachServerGroups

    更新時間：Jan 14, 2025

    對於需要動態調整執行個體數量來應對業務變化負載以及確保應用程式的高可用性情境，調用API AttachServerGroups為伸縮組添加一個或多個負載平衡伺服器組，支援的伺服器群組類型包括應用型負載平衡ALB和網路型負載平衡NLB，可以在業務變化時自動實現彈性擴充，並根據負載情況動態分配流量、提高應用程式的穩定性。

    調試

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

    請求參數

    名稱

    類型

    是否必選

    樣本值

    描述
    Action String 是 AttachServerGroups

    系統規定參數。取值：AttachServerGroups。
    RegionId String 是 cn-hangzhou

    伸縮組所屬的地區ID。
    ScalingGroupId String 是 asg-bp18p2yfxow2dloq****

    伸縮組的ID。
    ClientToken String 否 123e4567-e89b-12d3-a456-42665544****

    保證請求等冪性。

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

    是否將當前伸縮組內的ECS執行個體或ECI執行個體添加到新增的伺服器組。取值範圍：

    • true：添加。
    • false：不添加。

    預設值：false。
    ServerGroup.N.ServerGroupId String 是 sgp-60ofsqhwer0b***

    負載平衡伺服器組的ID。
    ServerGroup.N.Type String 是 ALB

    負載平衡伺服器群組類型。取值範圍：

    • ALB：應用型負載平衡ALB（Application Load Balancer）。
    • NLB：網路型負載平衡NLB（Network Load Balancer）。
    ServerGroup.N.Weight Integer 是 100

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

    權重越高，ECS執行個體或ECI執行個體將被分配到越多的訪問請求。如果權重為0，則ECS執行個體或ECI執行個體不會收到訪問請求。
    ServerGroup.N.Port Integer 是 22

    Auto Scaling將ECS執行個體或ECI執行個體添加到伺服器組後，ECS執行個體或ECI執行個體使用的連接埠號碼。

    取值範圍：1~65535。

    返回資料

    名稱

    類型

    樣本值

    描述
    ScalingActivityId String asa-bp1c9djwrgxjyk31****

    添加負載平衡伺服器組並將伸縮組內的ECS執行個體或ECI執行個體添加到該伺服器組時，伸縮活動的ID。

    說明 僅當ForceAttach取值為true時，返回該參數。
    RequestId String 74C4E313-8570-479F-8791-DC25360D****

    請求ID。

    樣本

    請求樣本

    http(s)://ess.aliyuncs.com/?Action=AttachServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceAttach=false
&ServerGroup=[{"ServerGroupId":"sgp-60ofsqhwer0b***","Type":"ALB","Weight":100,"Port":22}]
&公用請求參數

    正常返回樣本

    XML格式

    HTTP/1.1 200 OK
Content-Type:application/xml

<AttachServerGroupsResponse>
    <ScalingActivityId>asa-bp1c9djwrgxjyk31****</ScalingActivityId>
    <RequestId>74C4E313-8570-479F-8791-DC25360D****</RequestId>
</AttachServerGroupsResponse>

    JSON格式

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "ScalingActivityId" : "asa-bp1c9djwrgxjyk31****",
  "RequestId" : "74C4E313-8570-479F-8791-DC25360D****"
}

    錯誤碼

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