AttachAlbServerGroups - Auto Scaling

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

介面說明

向伸縮組添加ALB伺服器組時，需要滿足以下條件：

伸縮組的網路類型必須為VPC，且與ALB伺服器組處於同一VPC。
ALB伺服器組必須處於可用狀態。

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	AttachAlbServerGroups	系統規定參數。取值：AttachAlbServerGroups。
RegionId	String	是	cn-hangzhou	伸縮組所屬地區的ID。例如`cn-hangzhou`、c`n-shanghai`。更多資訊，請參見地區和可用性區域。
ScalingGroupId	String	是	asg-bp18p2yfxow2dloq****	伸縮組的ID。
ClientToken	String	否	123e4567-e89b-12d3-a456-42665544****	保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援ASCII字元，且不能超過64個字元。更多資訊，請參見如何保證等冪性。
ForceAttach	Boolean	否	false	是否將當前伸縮組內的ECS執行個體或ECI執行個體添加到新增的ALB伺服器組。 true：添加，並返回`ScalingActivityId`，您可以通過查看該伸縮活動ID來確定已有執行個體是否添加成功。 false：不添加。預設值：false。
AlbServerGroup.N.AlbServerGroupId	String	是	sgp-ddwb0y0g6y9bjm****	ALB伺服器組的ID。 N為ALB伺服器組的編號。一個伸縮組支援關聯的ALB伺服器組數量有限，如需查看或手動申請提升配額值，請前往配額中心。
AlbServerGroup.N.Weight	Integer	是	100	Auto Scaling將ECS執行個體或ECI執行個體添加到ALB伺服器組後，ECS執行個體或ECI執行個體作為後端伺服器的權重。N為ALB伺服器組的編號。權重越高，ECS執行個體或ECI執行個體將被分配到越多的訪問請求。如果權重為0，則ECS執行個體或ECI執行個體不會收到訪問請求。取值範圍：0~100。
AlbServerGroup.N.Port	Integer	是	22	Auto Scaling將ECS執行個體或ECI執行個體添加到ALB伺服器組後，ECS執行個體或ECI執行個體使用的連接埠號碼，取值範圍：1~65535。說明 N為ALB伺服器組的編號，如果N相同，Port不同，系統會預設向伸縮組關聯多個不同Port的該ALB伺服器組。

返回資料

名稱	類型	樣本值	描述
ScalingActivityId	String	asa-2ze6wxj8vsohn6j9****	添加ALB伺服器組並將伸縮組內的ECS執行個體或ECI執行個體添加到該ALB伺服器組時，伸縮活動的ID。說明僅當`ForceAttach`取值為`true`時，返回該參數。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	請求ID。

樣本

請求樣本

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

正常返回樣本

XML格式

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

<AttachAlbServerGroupsResponse>
    <ScalingActivityId>asa-2ze6wxj8vsohn6j9****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachAlbServerGroupsResponse>

JSON格式

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

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

錯誤碼

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

HttpCode	錯誤碼	錯誤資訊	描述
400	AlbServerGroup.NotExist	The ServerGroup "%s" do(es) not exist.	帳號下不存在指定的ALB伺服器組。
400	AlbServerGroup.AlreadyAttached	The ALB ServerGroups are already attached.	當前ALB伺服器組已經添加到伸縮組中。