對于需要動態調整實例數量來應對業務變化負載以及確保應用程序的高可用性場景,調用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實例添加到新增的服務器組。取值范圍:
默認值:false。 |
ServerGroup.N.ServerGroupId | String | 是 | sgp-60ofsqhwer0b*** | 負載均衡服務器組的ID。 |
ServerGroup.N.Type | String | 是 | ALB | 負載均衡服務器組類型。取值范圍:
|
ServerGroup.N.Weight | Integer | 是 | 100 | 彈性伸縮將ECS實例或ECI實例添加到服務器組后,ECS實例或ECI實例作為后端服務器的權重。取值范圍:0~100。 權重越高,ECS實例或ECI實例將被分配到越多的訪問請求。如果權重為0,則ECS實例或ECI實例不會收到訪問請求。 |
ServerGroup.N.Port | Integer | 是 | 22 | 彈性伸縮將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****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。